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 anotar ou discutir com 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".
Sobre subproblemas
Note
Os tipos de problemas, subproblemas e a pesquisa avançada de problemas estão atualmente em uma aceitação versão prévia pública para organizações. Para saber mais e adicionar sua organização à lista de espera, consulte o "Blog do GitHub".
Você pode adicionar subproblemas a um problema para dividir rapidamente partes maiores do trabalho em tarefas. Os subproblemas adicionam suporte para hierarquias de problemas no GitHub Enterprise Cloud 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 "Como navegar nos subproblemas."
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".
Projetos está fortemente integrado aos problemas. 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 obter mais informações, confira "Sobre notificações" e "Sobre 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. Consulte "Atribuir problemas e pull requests a outros usuários do GitHub" e "Exibir todos os problemas 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.
Consulte "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 obter mais informações, 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 o problema em uma discussão.