8.7 Explorando Issues no Mundo Real

Agora que já compreendemos o conceito de issues, é hora de consolidar esse conhecimento explorando como elas aparecem em projetos reais.

Um excelente exemplo para análise é o repositório brutils-python. Neste repositório, você encontrará diversas issues abertas e fechadas, cobrindo desde bugs e melhorias até discussões sobre novas funcionalidades.

Hora de Explorar!

Acesse o repositório https://github.com/brazilian-utils/brutils-python. Navegue pelas issues, experimente:

• Buscar por palavras-chave: Utilize a barra de busca para encontrar issues específicas, como "CPF" ou outras funcionalidades.

• Verificar issues fechadas: Muitas soluções e aprendizados estão documentados nas issues encerradas.

• Filtrar por labels: Você pode selecionar uma ou mais labels para encontrar issues relacionadas a bugs, melhorias ou novas features.

• Filtrar por autor: Veja as issues abertas por um usuário específico.

• Filtrar por assignees: Descubra quem está trabalhando em quais issues.

• Ordenar as issues: Escolha entre diferentes critérios, como mais recentes, mais comentadas ou mais reações.

• Explorar interações nas issues: Clique em uma issue e observe como a conversa se desenvolve, desde a descrição inicial até as soluções propostas.

Explorar issues reais ajuda a entender boas práticas de comunicação e gerenciamento dentro de projetos open source, além de preparar você para contribuir mais no futuro!

Próximos Passos

Neste capítulo, você criou a issue "Adicionar imagem de saudação ao README.md" para melhorar a documentação do seu repositório hello-world. Sabemos que você já sabe resolver essa tarefa da forma explicada anteriormente, realizando commits diretamente na branch main pela interface do GitHub. No entanto, esse fluxo não é recomendado quando se trabalha com outras pessoas ou mesmo em projetos individuais que não sejam apenas didáticos.

Por isso, queremos apresentar um fluxo de trabalho mais seguro e profissional, amplamente adotado tanto em projetos open source quanto em empresas. Esse ou um fluxo muito parecido será o que você encontrará ao contribuir para repositórios reais. Além disso, ele ajuda a manter o histórico de mudanças organizado, facilita a revisão de código e reduz o risco de erros que podem impactar a versão principal do projeto.

Para implementar esse fluxo, primeiramente precisamos aprofundar um pouco mais o conhecimento em Git, explorando como desenvolver em um repositório remoto — no caso, o seu hello-world — e não apenas no ambiente local como vimos até aqui nos capítulos 2, 3 e 4.