Participe do Hacktoberfest 2022 contribuindo com projetos de código aberto (guia completo)

Projetos de Código Aberto governam o mundo com sua qualidade de código geralmente boa, mas mais importante porque eles estão disponíveis gratuitamente. Isso também significa que a relação uso-contribuição é muito baixa,

Em outras palavras, algumas centenas de contribuintes trabalham na manutenção/melhoria desses projetos de código aberto em comparação com milhares ou milhões de usuários.

Hacktoberfest é um desses eventos da DigitalOcean que incentiva você a contribuir para seus projetos favoritos. Em troca de suas contribuições, você recebe um presente da DigitalOcean, ou pode optar por plantar uma árvore em vez disso.

Quem pode participar do Hacktoberfest?

Todos são bem-vindos para participar do Hacktoberfest 2022.

Você não precisa ser um desenvolvedor ou um estudante de ciência da computação. Se você é um artista, um escritor ou um tradutor, qualquer um pode contribuir para projetos de código aberto de uma forma ou de outra.

Por que você deve participar do Hacktoberfest?

Com o Hacktoberfest, a DigitalOcean está tentando conscientizar sobre projetos de código aberto. O objetivo é incentivar os usuários a explorar a aventura de um desenvolvedor de projetos de código aberto.

Você também percebe o valor do desenvolvedor que disponibiliza o código gratuitamente investindo em seu tempo, esforço e energia mental.

O evento Hacktoberfest incentiva você a apoiar seus projetos de código aberto favoritos. Assim, você pode garantir que o projeto/ferramenta que você ama melhora constantemente, e você começa a usá-lo para suas necessidades.

Afinal, o código aberto é sobre os esforços da comunidade e a prevenção do abuso de fornecedores. Então, você não pode esperar que o desenvolvedor faça todo o trabalho em seu benefício, certo?

"Mas o que eu consigo com isso?"

Este evento incentiva você a contribuir de volta para o projeto que você sente que é mais impactante para você. Isso garantirá que o projeto terá seu bug corrigido e novos recursos adicionados. Não apenas limitado à sua responsabilidade de retribuir, mais vantagens incluem:

• Aumentar sua criatividade
• Experimentar o que acontece por trás do desenvolvimento de projetos de código aberto (pode ajudá-lo profissionalmente também)
• Receber recompensas como uma camiseta do Hacktoberfest

Os benefícios mencionados acima são apenas o que quase todo mundo está falando. Mas há outros benefícios também. Contribuir para um projeto de código aberto irá melhorar seu portfólio e dizer ao seu futuro empregador que você pode trabalhar com a comunidade de código aberto.

Ele também ajuda você a aprender sobre a manutenção de seu projeto de código aberto no futuro, se você optar por fazê-lo. Aprender como a comunidade interage entre si ajudará você a moldar o projeto de código aberto do seu empregador ou do seu cliente de uma maneira que beneficie você e a comunidade em geral.

Sem mencionar que toda essa exposição a novas pessoas ao redor do mundo mostrará "como fazer x" de uma maneira diferente que será nova para você. Coisas assim ajudam você a pensar fora da caixa quando você estiver encurralado com um problema desafiador.

Para quais projetos devo contribuir?

Tecnicamente, você pode contribuir para qualquer projeto que quiser. Mas, existem projetos que não se alinham aos valores da Hacktoberfest; contribuir para esses projetos não será contado com seus objetivos totais para concluir o evento.

Por isso, é melhor procurar projetos no GitHub ou GitLab que tenham o tópico "Hacktoberfest".

• Você pode encontrar repositórios elegíveis no GitHub.
• Você pode encontrar repositórios elegíveis no GitLab.

Por favor, certifique-se de que o projeto para o que você está contribuindo tenha o tópico "Hacktoberfest". As contribuições feitas para outros projetos não podem ser contadas para o seu objetivo final.

O que posso fazer e como começar?

Primeiro, certifique-se de que você tenha registrado no Hacktoberfest usando sua conta GitHub ou GitLab.

Registre-se no Hacktoberbest

"Mas eu não sei programar, está tudo bem?"

Sim, isso é definitivamente bom! Contribuir para o código aberto não significa que você deve saber escrever código. Código é apenas uma parte do código aberto. Há muitas coisas que um projeto de código aberto pode precisar. Abaixo estão apenas algumas sugestões:

• Adicionar/Corrigir Código: Esta é a coisa óbvia que se pode pensar em contribuir para projetos de código aberto. Você pode enviar correções de bugs, novos recursos ou até mesmo corrigir um problema de segurança. Envie um pull request para um recurso que você sempre quis!
• Melhorar Documentação: A documentação é essencial para cada projeto. Os desenvolvedores lêem e os usuários precisam. Você pode ajudar a melhorar/corrigir a documentação.
• Ajudar na Tradução: Ser código aberto significa que qualquer pessoa em todo o mundo pode acessar seu projeto. Mas isso também significa que haverá pessoas que não serão capazes de escrever/ler/falar inglês. A tradução disponibilizada em sua língua nativa aumentará a colaboração.
• Criar Gráficos: Alguns projetos de software não têm ninguém que possa criar gráficos como um bom logotipo. Você também pode ajudar com essas tarefas.
• UI/UX design: Se você não pode contribuir com gráficos, você pode ajudar com o design UI/UX.

Você também pode ajudar a espalhar a palavra, e compartilhar o projeto com o mundo para melhorar sua presença social.

Além disso, você pode apoiar os projetos financeiramente se não tiver tempo para participar do Hacktoberbest.

Doe para Projetos

Coisas para saber antes de participar do Hacktoberfest

É fácil participar, mas há algumas coisas para saber para completar o Hacktoberfest (leia:"ganhar o Hacktoberfest"):

• Ser um usuário registrado do Hacktoberfest.
• Quaisquer pull requests enviaos no GitLab ou GitHub devem ser datados entre 1º de outubro e 31 de outubro (inclusive).
• Pelo menos quatro de seus pull requests devem ser mescladas ou aceitas nos respectivos repositórios.
• Seus pool requests devem ser enviados para repositórios que tenham o tópico "Hacktoberfest" nele, ou deve ser rotulado como "Hacktoberfest-accepted".

Observe que os primeiros 40.000 participantes que obterem seus pull requests mesclados terão direito a um prêmio da DigitalOcean. Para o Hacktoberfest 2022, o prêmio é uma camiseta do Hacktoberfest 2022. Você pode optar por plantar uma árvore em vez da camiseta.

Há mais algumas condições que podem afetar sua participação, essas incluem:

• Mais de dois pedidos de pull rotulados como "spam" irão desqualificar você para este Hacktoberfest e futuros eventos DigitalOcean.
• Quaisquer pull requests rotulados como "inválidos" (pelo mantenedor) serão descartadas do seu objetivo total.
• Qualquer pull request enviado para repositórios que não estejam alinhados com os valores do Hacktoberfest não será contado no seu total. No momento, não há nenhuma lista oficial que o notifique de tais repositórios. Se não tiver certeza, faça uma pergunta no servidor oficial do Hacktoberfest Discord.
• Evite enviar pull requests que são apenas ligeiramente benéficos ou estão lá apenas para introduzir uma pequena mudança. Exemplos incluem "Espaços brancos fixos", "Corrigir erros de digitação", "Código reformat usando espaços em vez de guias" e "Incrementar de 0 para i em vez de decrementar i para 0".

Como saber as Diretrizes de Contribuição para projetos?

Os repositórios que aceitam pedidos de retirada para o Hacktoberfest terão um arquivo chamado CONTRIBUTING.md, que inclui todas as informações necessárias para sua primeira contribuição para o referido repositório.

Embora mostramos o processo de contribuição para um projeto na próxima seção, você deve verificar as diretrizes de cada projeto antes de prosseguir.

O arquivo CONTRIBUTING.md geralmente contém alguns dos seguintes itens:

• Código de Conduta: Leia isso MUITO CUIDADOSAMENTE. Isso se refere ao comportamento aceitável de um indivíduo para esse projeto. Se você não conseguir manter isso, suas contribuições futuras podem passar despercebidas; eles podem até ser rejeitados imediatamente.
• Formatação de código: Cada projeto tem seu estilo de codificação. É melhor formatar o código de acordo com a formatação de códigos estabelecida na CONTRIBUTING.md
• ToC: Alguns projetos exigem que você aceite os termos e condições (sobre seus direitos ao seu código de contribuição) antes que sua solicitação de retirada se funda. Leia isso com atenção e certifique-se de que você está confortável com as restrições (se houver qualquer aplicação).
• Licença: Leia a licença sob a qual o código do repositório é disponibilizado. Você deve aderir à referida licença.
• Recursos contribuintes: Uma vez que este arquivo (CONTRIBUTING.md) é destinado a colaboradores iniciantes, você também receberá alguns recursos contribuintes para ajudá-lo a entender como uma revisão de código ocorre, e quais coisas precisam ser feitas um pull request para ser mesclada.
• Tags RP: Alguns mantenedores esperam que você crie um pull request usando uma tag. Algumas dessas tags podem ser "correção de bugs", "novo recurso", "primeiros problemas", etc. Isso ajuda o mantenedor e a comunidade a se concentrarem nas questões de seu interesse.
• Modelos de relatório de erro: Se você enviar uma pull request, às vezes você é obrigado a executar alguns comandos. Esses comandos podem fazer algumas coisas como "limpar arquivos de compilação", "remover arquivos de configuração personalizados", etc.
• Como configurar um ambiente de desenvolvimento: Às vezes, o arquivo CONTRIBUTING.md também listará todos os pacotes necessários para construir o projeto de software. Opcionalmente, você também será informado: "como empacotar isso". Esses itens serão incluídos para que você possa testar se suas alterações quebram algo antes de enviar uma solicitação de tração.
• Informação de propriedade: Esta seção incluirá detalhes como "Pessoa X trabalha com pull requests para correção de erros", então se o seu pull request para uma correção de bug não for aceito, você pode pedir à pessoa X para a entrada e como você pode melhorar seu pull request, para que ele seja aceita.

Como funciona todo o processo?

Agora que você está ciente dos pré-requisitos, como você procede? Como você faz seu primeiro pull request? É muito técnico para usuários iniciantes?

Não muito. Você só tem que digitar alguns comandos, e seguir um método passo a passo cuidadosamente. Não há nada muito difícil. Você só tem que ser paciente com todo o processo.

Resumindo, aqui está o que você tem que fazer:

1. Instalar e configurar o Git.
2. Criar uma conta no GitHub ou GitLab.
3. Bifurcar o repositório para o qual você deseja contribuir.
4. Trabalhar com o repositório usando Git.
5. Enviar o código/alteração para o repositório.

Como fazer seu primeiro pull request?

Não se preocupe, lhe daremos todos os passos na ordem correta para você começar.

1. Instale o Git no seu sistema

O Git é uma das ferramentas de controle de versão mais usadas no setor. Linus Torvalds o criou. Sim, a mesma pessoa que criou o Linux.

Antes de lhe dar uma visão geral básica do uso do git, vamos mostrar primeiro como você pode instalar git em seu computador.

Instalando git no Linux

Os usuários de distribuições Linux baseadas em Debian/Ubuntu podem usar o gerenciador de pacotes adequado para instalar o git. Pod ser feito com o seguinte comando:

Os usuários de distribuições Linux baseadas em Fedora/RHEL podem instalar o git usando o gerenciador de pacotes dnf assim:

Os usuários do Arch Linux podem instalar o git usando o gerenciador de pacotes pacman com o seguinte comando:

Instalando git no macOS

Os usuários de macOS podem instalar o git usando os brew ou macports os gerentes de pacotes.

Ou se você usar o port:

Instalando git no Windows

Usuários do Windows que preferem um arquivo .exe instalável, você pode baixá-lo a partir de lançamentos do GitHub.

Ou, se preferir usar um gerenciador de pacotes no Windows, use winget com o comando:

2. Configurando o Git

Uma vez instalado o git, alguma configuração precisa ser feita. O Git precisa do seu nome e endereço de e-mail para registrar um commit.

Você pode adicionar seu nome e endereço de e-mail ao git usando os seguintes comandos:

Isso ajudará os outros a saber quem fez qual mudança e como contatá-los. Para não esquecer que sem um nome e um e-mail fornecidos para git, você não será capaz de criar quaisquer commits.

Você pode consultar nosso guia de comandos Git para explorar outros comandos essenciais.

3. Criando uma conta no GitHub ou GitLab

Uma vez que o Git seja instalado e configurado, podemos proceder à criação de uma conta GitHub ou GitLab. Se você já tem uma conta, pule para o próximo passo.

Para criar uma conta no GitHub, clique aqui. Se você quiser criar uma conta GitLab, clique aqui.

Forneça seu nome e endereço de e-mail e escolha um nome de usuário adequado e uma senha forte. Uma vez que sua conta esteja configurada, é altamente aconselhável que você também configure a autenticação de dois fatores. A documentação para habilitar o 2FA no GitHub pode ser encontrada aqui, e os usuários do GitLab devem olhar aqui.

4. Como fazer para enviar um pull request?

Para participar do Hacktoberfest 2022, você deve ter 4 de seus pull requests aceitos/mesclados. Vamos demonstrar como você pode enviar um pull request.

Como o GitHub é mais popular entre as pessoas novas para a comunidade de código aberto, então vamos demonstrar o procedimento usando o GitHub. As etapas serão as mesmas para os usuários do GitLab, com apenas pequenas diferenças de interface do usuário.

a. Bifurque (fork) um repositório

A ação de "forking de repositório" refere-se à bifurcação ou criação de sua própria cópia do repositório para trabalhar nele. Então vamos encontrar alguns repositórios do Hacktoberfest no GitLab e GitHub para bifurcação.

Selecionamos o repositório compress-pdf no GitHub para esta demonstração. Visite o repositório de sua escolha e procure o botão "Fork".

Uma vez que você clica nele, você será levado para uma tela semelhante à captura de tela anexada abaixo. Você será solicitado a dar a este repositório um nome. É melhor manter o mesmo nome, mas você pode modificá-lo se quiser fazê-lo. Em seguida, clique no botão *Criar fork**. Isso criará um garfo de um determinado repositório.

Uma vez que você tenha o seu garfo do repositório, clone-o. É melhor fazer isso via SSH. Se você ainda não tiver configurado o SSH, você pode consultar sua documentação oficial.

Depois de clonar o repositório, você pode começar a trabalhar nele localmente.

Em seguida, vamos demonstrar como fazer isso, bem como como enviar essas alterações de volta ao "upstream" em forma de pull requests.

b. Trabalhando com um repo Git, localmente

Depois de clonar um repositório localmente, crie imediatamente um novo ramo (branch). Use um nome apropriado que melhor descreva suas alterações. Abaixo está o comando para criar um novo ramo no git:

Usando o comando git checkout junto com a opção -b, você será automaticamente trocado para este ramo e poderá começar com o seu trabalho.

Você pode ver suas modificações usando o comando git diff.

Se você está satisfeito com suas mudanças, agora é a melhor hora para verificar se elas funcionam ou não. Uma vez verificado, você pode usar o comando git add para adicionar essas alterações à área de staging.

Em seguida, use git commit para criar um commit junto com uma mensagem útil.

c. Enviando o código para o repositório

Agora que você trabalhou na implementação de algo ou em alguma mudança e gerou o commit, agora é hora de enviar esse código de volta para o repositório original. Antes que isso seja feito, nossas mudanças precisam ir em nosso repositório bifurcado.

Para enviar nossas alterações (que foram feitas em um ramo separado), use o comando git push da seguinte forma:

O ramo que você criou anteriormente será enviado para o repositório bifurcado.

Após a conclusão da operação, se você estiver usando o GitHub, você verá uma mensagem que lhe fornecerá um link. Visitar esse link criará uma solicitação de tração para seu ramo. Como isso é específico do GitHub, mostraremos um método alternativo para criar um pull request.

No seu navegador, navegue até o fork do repositório. Você verá um botão que diz "Compare & pull request".

Clicando nele, você será levado a uma página web que pedirá um comentário. Aqui é onde você descreve coisas como "Por que meu commit é útil", "O que faz o meu commit", "Se a fusão do meu commit quebrará qualquer código existente", etc.

Depois de escrever um comentário com todos os detalhes, clique no botão "Criar solicitação de envio". Parabéns!

Você acabou de enviar seu primeiro pull request!

É o seu primeiro, e que você possa contribuir mais

Os primeiros pull requests sempre vão fazer você se sentir nervoso com as mudanças que você acabou de enviar. Não se preocupe, esse nervosismo vai embora depois que você ficar confortável.

À medida que o proprietário do projeto ou o mantenedor fica livre o suficiente, eles vão dar uma olhada no seu pull request. Se todas as mudanças parecerem bem para eles, o pull request será mesclado. Que legal!

Caso seu pull request não seja mesclada, não se preocupe. Educadamente aproxime-se da pessoa que rejeitou seu pull request. Peça-lhe feedback sobre onde o problema estava e o que poderia ser feito para que sua mudança se fundisse.

Você introduziu uma nova biblioteca/dependência que tinha uma alternativa melhor? Ou há algo que pode ser corrigido?

É claro que os mantenedores podem não responder a todas as consultas que você tem. Portanto, certifique-se de não incomodá-los repetidamente depois de ter enviado sua dúvida sobre o pull request.

Não ter um pull request mesclado não é o fim do mundo. Experimente com outros projetos utilizando sua paixão e criatividade!