Você pode criar problemas em seu repositório para planejar, discutir e acompanhar o trabalho. Os problemas são rápidos de criar, flexíveis e podem ser usados de várias maneiras. Os problemas podem acompanhar relatórios de bugs, novos recursos e ideias e qualquer outra coisa que você precise escrever ou discutir com sua equipe, e você pode usar o projects para planejar e acompanhar o trabalho para sua equipe.
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 subproblemas, converter um comentário em um problema ou pull request, criar um problema a partir de uma linha de código específica ou por meio de uma consulta de URL. Você também pode criar um problema a partir da sua plataforma de escolha: por meio da interface do usuário web GitHub Desktop, GitHub CLI, GraphQL e APIs REST ou GitHub Mobile. Confira Criar um problema.
Dica
Você também pode usar o Copilot Chat para gerar ideias, estruturas de tópicos ou rascunhos de 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 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. Confira Como adicionar subproblemas e Como navegar nos 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.
Confira 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 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.
Como usar o Projetos para planejar e acompanhar seu trabalho
O Projetos está fortemente integrado a problemas para planejar e acompanhar o trabalho para 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 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 Atribuir problemas e pull requests a outros usuários do GitHub e Exibindo todos os issues e pull requests.
Gerenciamento da comunidade
Para ajudar os colaboradores a abrir problemas significativos que fornecem as informações necessárias, use formulários de problemas e modelos de problemas. Confira Usando modelos para incentivar problemas úteis e receber pull request.
Para manter uma comunidade íntegra, denuncie os comentários que violam as Diretrizes da Comunidade do GitHub. Confira 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 problemas. Se você se encontrar, frequentemente, digitando o mesmo comentário, você poderá usar as respostas salvas.
Confira Sintaxe básica de gravação e formatação no GitHub e Atribuir problemas e pull requests a outros usuários do 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, confira Comunicar-se no GitHub.
Quando uma conversa em um problema é mais adequada para uma discussão, você pode converter a questão em uma discussão.
Próximas etapas
Veja alguns recursos úteis para dar seus próximos passos com o 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 os conceitos básicos para usar as ferramentas de planejamento e acompanhamento do GitHub, confira 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.