Você pode criar problemas em seu repositório para planejar, discutir e acompanhar o trabalho. As questões são rápidas de criar, flexíveis e podem ser usadas de várias maneiras. As issues podem ser usadas para acompanhar relatos de bugs, novas funcionalidades, ideias e qualquer outra coisa que você precise registrar ou discutir com sua equipe, e você pode usar projetos para planejar e acompanhar o trabalho da sua equipe. Você também pode dividir ainda mais seu trabalho adicionando subitens e explorar facilmente toda a hierarquia do trabalho a ser feito.
Os problemas podem ser criados de várias maneiras. Portanto, você pode escolher o método mais conveniente para seu fluxo de trabalho. Por exemplo, você pode criar um problema a partir de um repositório, ao adicionar sub-problemas, converter um comentário em um problema ou solicitação de pull, criar um problema de uma linha de código específica ou por meio de uma consulta de URL. Você também pode criar uma issue na plataforma de sua escolha: pela interface web, GitHub Desktop, GitHub CLI, APIs GraphQL e REST ou GitHub Mobile. Confira Criar um problema.
Dica
Você também pode usar Bate-papo do Copilot para gerar ideias, estruturas de tópicos ou rascunhos para discussões ou postagens no blog, com base em seus problemas. Confira Escrevendo discussões ou postagens no blog.
Sobre subproblemas
Você pode adicionar subproblemas a um problema para dividir rapidamente partes maiores do trabalho em problemas menores. Os subproblemas adicionam suporte para hierarquias de problemas no GitHub com a criação de relacionamentos entre os problemas. Você pode criar vários níveis de subproblemas que representam com precisão seu projeto, dividindo com exatidão as tarefas no nível de detalhe que você e sua equipe precisam. Consulte Como adicionar subproblemas e Navegando em subproblemas.
Sobre dependências de problema
Você pode definir relações de bloqueio entre problemas usando dependências de problemas. As dependências de problemas permitem identificar problemas bloqueados por, ou que estão bloqueando, outros trabalhos. Confira Como criar dependências de problema.
Metadados sobre problemas
Você pode adicionar metadados aos seus problemas, incluindo tipos de problemas, rótulos e marcos para organizar seus problemas.
Consulte Como gerenciar tipos de problemas em uma organização, Gerenciar etiquetas e Sobre marcos.
Sobre a integração com GitHub
Os problemas se integram ao seu trabalho em todo o GitHub. Mencionar um problema em outro problema ou pull request criará referências entre eles e o uso de palavras-chave, como fixes:, em suas pull requests, fechará automaticamente os problemas associados. Confira Vinculando uma pull request a um problema.
Usar Projetos para planejar e acompanhar seu trabalho
Projetos é totalmente integrado aos itens para planejar e acompanhar o trabalho da sua equipe. Todos os metadados do problema estão disponíveis em seus projetos, permitindo que você crie exibições e filtros para representar seu trabalho. Confira Sobre o Projects.
Mantenha-se atualizado
Para manter-se atualizado sobre os comentários mais recentes em um problema, você pode assinar um problema para receber notificações sobre os comentários mais recentes. Para encontrar links para problemas atualizados recentemente nos quais você está inscrito, visite seu painel. Para saber mais, confira Sobre notificações e Início Rápido para seu painel pessoal.
Você pode atribuir a si mesmo e aos colegas de equipe problemas para deixar claro quem está trabalhando em um problema e também facilitar a localização de seus problemas. Confira Atribuindo problemas e solicitações de pull a outros usuários GitHub e Exibição de todos os problemas e solicitações de pull.
Gerenciamento da comunidade
Para ajudar os colaboradores a abrir relatos relevantes que forneçam as informações de que você precisa, você pode usar formulários de relatos e modelos de relatos. Confira Usando modelos para incentivar problemas úteis e receber pull request.
Para manter uma comunidade íntegra, você pode relatar comentários que violam GitHubas Diretrizes da Comunidade. Consulte Denunciar abuso ou spam.
Comunicação eficiente
Você pode @mention colaboradores que têm acesso ao seu repositório em um problema para chamar a atenção deles para um comentário. Para vincular problemas relacionados no mesmo repositório, digite # seguido de uma parte do título do problema e clique no problema que deseja vincular. Para comunicar responsabilidade, você pode atribuir questões. Se você se encontrar, frequentemente, digitando o mesmo comentário, você poderá usar as respostas salvas.
Consulte Sintaxe básica de escrita e formatação e Atribuindo problemas e solicitações de pull a outros usuários GitHub.
Comparando problemas e discussões
Algumas conversas são mais adequadas para GitHub Discussions. Use o GitHub Discussions para fazer perguntas e responder a elas, compartilhar informações, fazer comunicados e conduzir uma conversa sobre um projeto ou participar dela. Para saber mais, confira Sobre discussões. Para obter diretrizes sobre quando usar um problema ou uma discussão, consulte Comunicando-se no GitHub.
Quando uma conversa em um tópico é mais apropriada para discussão, você pode converter o tópico em uma discussão.
Próximas etapas
Aqui estão alguns recursos úteis para executar suas próximas etapas com GitHub Issues:
- Para saber mais sobre como começar a usar problemas, confira Início rápido para problemas no GitHub.
- Para saber mais sobre o essencial para usar as ferramentas de planejamento e acompanhamento do GitHub, consulte Planejamento e rastreamento de trabalho para a sua equipe ou projeto.
- Para saber mais sobre como os projetos podem ajudar você com o planejamento e o acompanhamento, confira Mais informações sobre Projects.