Você pode criar problemas em seu repositório para planejar, discutir e acompanhar o trabalho. As questões são rápidas de criar, flexíveis e podem ser usadas de várias maneiras. As issues podem ser usadas para acompanhar relatos de bugs, novas funcionalidades, ideias e qualquer outra coisa que você precise registrar ou discutir com sua equipe, e você pode usar projetos para planejar e acompanhar o trabalho da 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 solicitação de pull, criar um problema de uma linha de código específica ou por meio de uma consulta de URL. Você também pode criar uma solicitação a partir da plataforma de sua escolha: pela interface web, GitHub Desktop, GitHub CLI, APIs GraphQL e REST ou GitHub Mobile. Confira Criar um problema.
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 rótulos e marcos para organizar seus problemas.
Consulte Gerenciar etiquetas e Sobre marcos.
Sobre a integração com GitHub
As solicitações se integram ao seu trabalho em toda a 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.
Usar Projetos para planejar e acompanhar seu trabalho
Projetos está fortemente integrada às solicitações para planejar e acompanhar o trabalho da 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 o 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 Atribuindo problemas e solicitações de pull a outros usuários GitHub e Exibição de todos os problemas e solicitações de pull.
Gerenciamento da comunidade
Para ajudar os colaboradores a abrir solicitações relevantes que forneçam as informações necessárias, você pode usar modelos de solicitação. 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 questões. 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 saber mais, confira Sobre discussões. Para obter diretrizes sobre quando usar um problema ou uma discussão, consulte Comunicando-se no GitHub.
Quando uma conversa em um tópico é mais apropriada para discussão, você pode converter o tópico em uma discussão.
Próximas etapas
Aqui estão alguns recursos úteis para executar suas próximas etapas com 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 o essencial para usar as ferramentas de planejamento e acompanhamento do GitHub, consulte 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.