Skip to main content

Sobre issues

Use GitHub Issues para rastrear ideias, comentários, tarefas ou erros para trabalho em GitHub.

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, um item em uma lista de tarefas, 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 acompanhar problemas como parte de um problema maior, você pode usar listas de tarefas. Para categorizar problemas relacionados, você pode usar rótulos e marcos.

Para obter mais informações sobre projetos, confira "Sobre Projects." Para obter mais informações sobre listas de tarefas, confira "Sobre listas de tarefas." 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 formulários de problemas e modelos de problemas. Para obter mais informações, confira "Usando modelos para incentivar problemas úteis e receber pull request".

Para manter uma comunidade benéfica, denuncie os comentários que violam as Diretrizes da Comunidade do GitHub. Para obter mais informações, 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. Para mais informações, 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 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.