Identificar onde pode ajudar

Concluído

Nesta unidade, discutiremos como você pode começar com contribuições de código aberto. Também iremos utilizar problemas e etiquetas para encontrar tarefas para as quais contribuir.

O software de código aberto pode ser usado livremente, modificado e compartilhado por qualquer pessoa. Usando software de código aberto, qualquer pessoa pode visualizar, modificar e distribuir um projeto para qualquer finalidade. A ideia por trás do software de código aberto é que o compartilhamento de código leva a um software melhor e mais confiável.

Existem muitas formas de contribuir para projetos open source. Fazer a sua primeira contribuição pode muitas vezes ser uma experiência assustadora, mas não deveria ser. O open source é um local para todas as pessoas e as contribuições acontecem a todos os níveis.

Encontrar um projeto open source que precise de contribuições

Pode começar por pensar nos projetos que já utiliza ou quer utilizar. Contribuir é fácil quando está familiarizado com o projeto e a respetiva comunidade.

Talvez ao ler o arquivo LEIA-ME de um projeto, você encontre um link quebrado ou alguns erros de digitação. Talvez você tenha notado que algo não está funcionando como esperado ou que a documentação está desatualizada. Tudo isto são boas oportunidades para ajudar e contribuir para o projeto.

Gorjeta

Uma dica importante: todos os tipos de contribuições são valiosas. Não importa qual é o seu nível de experiência ou conhecimento sobre o projeto. Todos temos algo com que podemos contribuir. Tenha confiança em si. O mais importante é ter vontade de ajudar.

Utilizar a pesquisa do GitHub

Também pode utilizar a pesquisa do GitHub para explorar tópicos e projetos relacionados. Vá para a pesquisa do GitHub e digite a palavra do tópico.

Imagine que tem interesse em machine learning.

Em seguida, você pode restringir sua pesquisa selecionando Tópicos na barra lateral esquerda.

A partir daí, pode encontrar repositórios relevantes à sua chave de pesquisa e repositórios organizados por membros da comunidade.

Familiarizar-se com um projeto open source

Será relevante mencionar aqui que todas as comunidades open source são diferentes. Após encontrar um projeto, terá de se familiarizar com o mesmo e as respetivas diretrizes de participação.

A maioria dos projetos terá estes documentos no nível superior do repositório:

• LICENÇA: O projeto deve conter uma licença de código aberto. Se o projeto não tiver uma licença, não é open source.
• LEIA-ME: O arquivo LEIA-ME geralmente serve como a página de boas-vindas para o projeto. Ele geralmente fornece informações sobre como começar a usar o projeto. Também é comum que inclua informações sobre como interagir com a comunidade.
• CONTRIBUINDO: Como o próprio nome sugere, este documento fornece orientações sobre como contribuir para o projeto. Ele geralmente descreve como o processo de contribuição funciona e inclui detalhes sobre como configurar seu ambiente de desenvolvimento.
• CODE_OF_CONDUCT: O código de conduta estabelece regras básicas para os membros da comunidade. Ao fazê-lo, ajuda a tornar a comunidade um ambiente seguro e acolhedor para todas as pessoas.

Apesar de nem todos os projetos terem um documento CONTRIBUTING ou CODE_OF_CONDUCT, ter estes documentos é uma boa indicação do nível de companheirismo e boa receção de um projeto.

Os colaboradores open source e os responsáveis pela manutenção de projetos estão em todo o mundo. Normalmente, os projetos têm vários canais de comunicação para organizar debates e pedir ajuda. Uma boa forma de se familiarizar com a comunidade é ao ler alguns destes canais de comunicação:

• Rastreador de problemas: Onde as pessoas discutem questões e tarefas relacionadas ao projeto. Para encontrar os problemas no GitHub, você pode ir para a página principal do repositório no GitHub e adicionar /issues ao final da URL, por exemplo: https://github.com/jupyter/notebook/issues.
• Pull request: Onde as pessoas discutem e analisam as alterações ao projeto. Pode encontrá-lo no GitHub ao adicionar pulls ao URL do projeto, por exemplo, https://github.com/jupyter/notebook/pulls.
• Canais e fóruns de chat: Alguns projetos usam canais de bate-papo, como Slack, Gitter e IRC, ou fóruns como o Discourse para conversas e discussões.

Identificar tarefas em que trabalhar

Você encontrou um projeto, leu as diretrizes de contribuição e agora está pronto para contribuir.

Talvez você já tenha identificado algo para trabalhar, como corrigir links quebrados ou atualizar os documentos. Uma boa maneira de encontrar problemas para iniciantes para ajudar é visitando o URL do /contribute projeto, por exemplo: https://github.com/jupyter/notebook/contribute.

Irá reparar que a maioria dos problemas apresentados no URL contribute têm etiquetas, como good-first-issue, help wanted, beginner-friendly e assim sucessivamente. As etiquetas são frequentemente utilizadas para fornecer informações de nível superior sobre o problema e o tipo de ajuda necessária.

Pode aceder à página de etiquetas, por exemplo: https://github.com/jupyter/notebook/labels. Em seguida, selecione questões que tenham rótulos como help wanted, discussionou outros rótulos relevantes para o tipo de contribuição em que você está interessado.

À medida que explora os problemas, também poderá reparar que alguns têm outros problemas ou pedidos Pull associados.

Patrocinar um projeto

Existem muitas formas de contribuir para projetos open source. Pode suportar financeiramente as pessoas que criam e mantêm o ecossistema open source através de código, liderança, mentoria, estruturação e mais.

Os projetos open source dependem muito do trabalho voluntário. O GitHub Sponsors permite-lhe financiar projetos e pessoas para as ajudar nos seus trabalhos open source e dar-lhes o reconhecimento que merecem.

Se um projeto for elegível para patrocínio através dos Patrocinadores do GitHub, você encontrará um botão Patrocinador na página principal do projeto.

Pode selecionar o escalão de patrocínio e se pretende que a sua contribuição seja pública.

Recapitulação da Unidade

Nesta unidade, aprendeu a iniciar contribuições open source, Agora sabe como escolher um projeto no qual trabalhar e utilizar os problemas e etiquetas do GitHub para identificar tarefas a realizar.

Segue-se uma lista de verificação útil ao interagir com um projeto pela primeira vez:

• Tem uma licença?
• Os debates de problemas e pedidos Pull são utilizados ativamente pelos contribuidores e pelos responsáveis pela manutenção?
• O projeto utiliza etiquetas como help wanted ou good first issue para principiantes?
• O projeto tem um código de conduta?
• O projeto tem Diretrizes de Contribuição claras?

Por último, lembre-se de que todas as contribuições são bem-vindas e que o ecossistema open source beneficia bastante das suas ideias e participação. Existem muitas formas de contribuir para um projeto open source, desde a submissão de código ou a participação em debates de projeto até ao patrocínio de projetos através do GitHub Sponsors.