> For the complete documentation index, see [llms.txt](https://cumbucadev.gitbook.io/github-essentials/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cumbucadev.gitbook.io/github-essentials/dia-8/explorando-issues-no-mundo-real.md). # 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](https://github.com/brazilian-utils/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 . 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. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://cumbucadev.gitbook.io/github-essentials/dia-8/explorando-issues-no-mundo-real.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.