Skip to main content

Sobre issues

Saiba como usar GitHub Issues para acompanhar ideias, feedback, tarefas ou bugs.

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, 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 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 modelos de problemas. 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.