Introdução
Este guia demonstra como usar GitHub Issues para planejar e rastrear um trabalho. Neste guia, você criará um problema e o dividirá em subproblemas. Você também aprenderá a adicionar rótulos, tipos de problema, marcos, destinatários e projetos para comunicar metadados sobre o problema.
Pré-requisitos
Para criar um problema, você precisa de um repositório. Você pode usar um repositório existente ao qual você tem acesso de gravação ou criar um novo repositório. O repositório deve ter problemas habilitados. Para saber mais sobre como criar um repositório, confira AUTOTITLE. Para obter mais informações sobre como habilitar os problemas se eles estiverem desabilitados no seu repositório, confira AUTOTITLE.
Abrir um problema em branco
Primeiro, crie um problema. Existem várias maneiras de criar um problema. Você pode escolher o método mais conveniente para seu fluxo de trabalho. Este exemplo usará o UI de GitHub Para obter mais informações sobre outras maneiras de criar uma questão, consulte AUTOTITLE.
-
Em GitHub, acesse a página principal do repositório.
-
No nome do seu repositório, clique em Issues.
-
Clique em Novo problema.
-
Neste exemplo, começaremos com um item em branco. Seu repositório poderá usar modelos de problemas para incentivar os colaboradores a fornecer informações específicas. Se o repositório usar modelos de problema, clique em Abrir um problema em branco.
Preenchimento de informações
Dê um título descritivo ao seu problema. O título deverá transmitir resumidamente o problema.
Adicione uma descrição que explique o propósito do problema, incluindo todos os detalhes que possam ajudar a resolvê-lo. Por exemplo, se este for um relatório de erro, descreva as etapas para reproduzir o erro, o resultado esperado e o resultado real.
Você pode usar o markdown para adicionar formatação, links, emojis e muito mais. Para saber mais, confira AUTOTITLE.
Adicionando uma lista de tarefas
Você também pode usar texto simples para acompanhar as tarefas que não têm um problema correspondente e convertê-las em problemas posteriormente. Para saber mais, confira AUTOTITLE.
Atribuindo a tarefa
Para comunicar responsabilidade, você pode atribuir a questão a um integrante da sua organização. Consulte AUTOTITLE
Adicionando etiquetas
Adicione uma etiqueta para categorizar o seu problema. Por exemplo, você pode usar um rótulo e um rótulo para indicar que um problema é uma questão que um colaborador que está contribuindo pela primeira vez pode detectar. Os usuários podem filtrar problemas por etiqueta para encontrar todos os problemas com uma etiqueta específica.
Você pode usar as etiquetas padrão ou criar uma nova. Para saber mais, confira AUTOTITLE.
Como adicionar tipos de problema
Você pode adicionar um tipo de problema para classificar o trabalho em toda a organização. Consulte AUTOTITLE
Adicionando o problema a um projeto
Você pode adicionar o problema a um projeto existente e preencher metadados para o projeto. Para obter mais informações sobre projetos, confira AUTOTITLE.
Adicionar marcos
Você pode adicionar um marco para acompanhar o problema como parte de um destino baseado em data. Um marco mostra o progresso das questões à medida que se aproxima a data-alvo. Consulte AUTOTITLE
Enviando o seu problema
Clique em Enviar novo problema para criar seu problema. Você pode editar qualquer um dos campos acima após a criação do problema. Seu problema tem uma URL única que você pode compartilhar com os integrantes da equipe ou fazer referência a outros problemas ou pull requests.
Como adicionar subproblemas
Você pode adicionar subproblemas a um problema para dividir rapidamente partes maiores do trabalho em problemas menores. Os subproblemas adicionam suporte para hierarquias de problemas no 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. Confira AUTOTITLE e AUTOTITLE.
Como adicionar 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. Consulte AUTOTITLE
Comunicar
Depois que o seu problema for criado, continue a conversa adicionando comentários ao problema. Você pode colaboradores ou equipes 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 saber mais, confira AUTOTITLE.
Próximas etapas
Você pode usar questões para uma grande variedade de finalidades. Por exemplo:
- Rastrear ideias
- Recolhendo feedback
- Planejar tarefas
- Como relatar bugs
Para dividir seu problema em tarefas mais gerenciáveis, você pode adicionar vários níveis de subproblemas. Consulte AUTOTITLE
Aqui estão alguns recursos úteis para tomar seus próximos passos com o GitHub Issues:
- Para saber mais sobre os problemas, confira AUTOTITLE.
- Para saber mais sobre os conceitos básicos para usar as ferramentas de planejamento e acompanhamento do GitHub, confira AUTOTITLE.
- Para saber mais sobre como os projetos podem ajudar você com o planejamento e o acompanhamento, confira AUTOTITLE.
- Para saber mais sobre como usar modelos de problemas para incentivar os colaboradores a fornecer informações específicas, confira AUTOTITLE.