Sobre issues
Os GitHub Issues são itens que podem ser criados em um repositório para planejar, discutir e monitorar o trabalho.
Eles são simples de criar e flexíveis para se adequar a uma variedade de cenários. Você pode usá-los para acompanhar o trabalho, dar ou receber feedback, colaborar com ideias ou tarefas e se comunicar eficientemente com outras pessoas.
Integrados com o GitHub
Os issues permitem que você acompanhe seu trabalho no GitHub. Ao mencionar um problema em outro problema ou pull request, a linha do tempo do problema reflete a referência cruzada para que você possa acompanhar o trabalho relacionado. Para indicar que o trabalho está em andamento, você pode vincular um problema a um pull request. Quando o pull request faz merge, o problema vinculado é fechado automaticamente.
Para obter mais informações sobre palavras-chave, confira "Vinculando uma pull request a um problema".
Crie problemas rapidamente
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 por meio de um repositório, uma observação em um projeto, um comentário em uma solicitação de pull ou em um problema, uma linha de código específica ou 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. Para obter mais informações, confira "Criar um problema".
Monitorar trabalho
Você pode organizar e priorizar problemas com projetos. Para categorizar problemas relacionados, você pode usar rótulos e marcos.
Para obter mais informações sobre projetos, confira "Sobre Projects (beta)." Para obter mais informações sobre rótulos e marcos, confira "Usando etiquetas e marcos para monitorar o trabalho".
Fique 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."
Gerenciamento da comunidade
Para ajudar os colaboradores a abrir problemas significativos que fornecem as informações necessárias, use modelos de problemas. Para obter mais informações, confira "Usando modelos para incentivar problemas úteis e receber pull request".
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.
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.