[pt-BR] Quinta do Patinho - Especial HackertoberFest

Key Concepts

• Quinta do Patinho (Duck Friday): A live stream event where the host uses the audience (chat) as "rubber ducks" to debug code and discuss open-source projects.
• Rubber Duck Debugging: A method of debugging where a programmer explains a problem to an inanimate object (like a rubber duck) to help them find the solution.
• Hacktoberfest: An annual event created by DigitalOcean to encourage contributions to open-source projects. Participants need to make a certain number of valid pull requests (PRs) to receive rewards.
• Open Source: Software with source code that anyone can inspect, modify, and enhance.
• Pull Request (PR): A request to merge changes from a branch into another branch, typically used in open-source projects to propose contributions.
• NFTs (Non-Fungible Tokens): Digital assets that represent ownership of unique items, used in Hacktoberfest as digital badges.
• GitHub: A web-based platform for version control and collaboration, widely used for open-source projects.
• VS Code (Visual Studio Code): A popular source-code editor developed by Microsoft.
• CodeSpaces: A cloud-based development environment provided by GitHub, allowing users to code directly in the browser.
• AI (Artificial Intelligence): Tools like GitHub Copilot that can assist in coding and documentation.

Summary

Introduction and Personal Update

The host begins by acknowledging her absence from live streams and her unfamiliarity with the current streaming setup, humorously noting the presence of a "duckling" on screen. She apologizes for being late and explains her recent hiatus due to personal challenges: a first-time experience with an anxiety crisis requiring intensive treatment and the death of a close friend. She emphasizes that this live stream is work-related but wants to share her personal situation with her supportive audience.

Quinta do Patinho and Hacktoberfest

The "Quinta do Patinho" (Duck Friday) is explained as a live session where the host uses the chat as "rubber ducks" to debug code and work on open-source projects. This month's focus is Hacktoberfest, an annual event encouraging open-source contributions. The host details the event's history, its goal of promoting open-source, and the rewards, which include exclusive t-shirts (for the first 10,000 participants), digital badges (NFTs), and tree planting.

Participating in Hacktoberfest

To participate, individuals must register on the Hacktoberfest website using their GitHub account. The core requirement is to submit six valid and accepted pull requests (PRs) to open-source projects. The host clarifies what constitutes a "valid project" (must have the #hacktoberfest tag in its description) and a "valid PR." Contributions should be useful and not merely superficial changes like adding a comma. Examples of valid contributions include fixing typos, improving documentation, adding event details to a calendar, or contributing code. The host stresses that contributions don't need to be complex; even small, useful changes are valuable. She also mentions that contributions to personal projects within an organization also count.

Finding Projects and Making Contributions

The host suggests several ways to find suitable projects:

• Filtering by #hacktoberfest tag: Projects must explicitly tag themselves for Hacktoberfest.
• Looking for "good first issue" or "help wanted" labels: These are often good starting points for new contributors.
• Contributing to documentation: This is highlighted as a crucial and accessible way to contribute, especially for beginners.
• Asking for help: The issue tracker is a place to ask questions and get clarification from maintainers.
• Using AI tools like GitHub Copilot: Copilot can assist with code generation, documentation improvement, and understanding issues. However, the host strongly advises reviewing AI-generated content as it can be limited by context and may contain errors. She emphasizes that while AI won't replace jobs, individuals who know how to use AI effectively will have an advantage.

Examples and Case Studies

• Meteor GS: Mentioned as a framework that is currently accepting PRs for Hacktoberfest.
• Personal Projects: The host shows her personal repository for fibromyalgia as an example of a project where contributions would count.
• Community Extensions: A repository for IDE extensions (VS Code, PHPStorm) is suggested as a place for contributions.
• Globo Source: The host discovers that Globo (a Brazilian media company) has its own open-source initiative, and some participants have contributed to their projects.
• AI Assistance: The host demonstrates using Copilot to improve the documentation of her fibromyalgia project, asking for suggestions on improving the README and installation instructions.

Rewards and Logistics

• Digital Badges (NFTs): Participants earn digital badges for various achievements, which can be displayed on their GitHub profiles. These are primarily for recognition and do not have monetary value.
• T-shirts: The first 10,000 participants receive a t-shirt. The host explains the process of claiming the t-shirt, noting that the shipping options might not explicitly list South America, but participants should select the closest option (e.g., North America/USA) for delivery to Brazil.
• Tree Planting: A tree is planted in the participant's name.

Technical Details and Tools

• Git Flow: The host mentions that Hacktoberfest is a good opportunity to practice Git flow, which involves cloning repositories, making changes, and submitting PRs.
• CodeSpaces: The host praises CodeSpaces for allowing development directly in the browser without local setup, but also notes a situation where it failed due to poor internet connectivity among workshop participants. She advises using traditional local setups when internet reliability is a concern.
• VS Code Themes: The host expresses interest in creating a VS Code theme in a future live stream.

Conclusion and Call to Action

The host reiterates the importance of contributing to open source and encourages viewers to participate in Hacktoberfest. She offers assistance to anyone needing help with their contributions via LinkedIn or their WhatsApp group. She also mentions that next week's live stream might have a Halloween theme. The session concludes with a reminder that the "Quinta do Patinho" is a collective effort and a fun way to engage with open source.