Como adicionar subproblemas

Saiba mais sobre como usar subproblemas para dividir seu trabalho em tarefas.

Quem pode usar esse recurso?

People with at least triage permissions for a repository can add sub-issues.

Neste artigo

Você pode adicionar subtarefas a uma questão para dividir partes maiores do trabalho em tarefas. Seus subitens mostram a relação deles com o item principal, permitindo que você acompanhe seu trabalho em GitHub. Itens pai e o progresso de subitens também estão disponíveis em seu projetos, permitindo que você crie visualizações, filtre e agrupe por item pai.

Seus subproblemas podem conter subproblemas, permitindo que você crie hierarquias completas de problemas que abrangem projetos inteiros ou partes de trabalho e mostram as relações entre seus problemas.

Você pode adicionar até 100 subitens por item pai e criar até oito níveis de subitens aninhados.

Como criar um subproblema

  1. Navegue até o problema ao qual você deseja adicionar um subproblema.
  2. Na parte inferior da descrição do problema, clique em Criar subproblema.
  3. Na caixa de diálogo, digite o título do seu subproblema.
  4. Opcionalmente, digite a descrição do problema e defina o tipo de problema e quaisquer atribuições, rótulos, projetos e marcos.
  5. Opcionalmente, se você quiser continuar a criar sub-tarefas para esta tarefa principal, selecione Criar mais sub-tarefas.
  6. Clique em Criar.

Como adicionar um problema existente como subproblema

  1. Navegue até o problema ao qual você deseja adicionar um subproblema.

  2. Na parte inferior da descrição do problema, ao lado de "Criar subproblema", clique em .

    Captura de tela da seção de subproblemas abaixo da descrição do problema. O botão "Mostrar mais opções de subproblemas" é realçado com um retângulo laranja.

  3. No menu suspenso, clique em Adicionar problema existente.

  4. Selecione o problema que você deseja adicionar como um subproblema.

    • Selecione um problema em uma das sugestões.
    • No campo "Pesquisar problemas", digite o título ou o número do problema e clique nos resultados.
    • Para adicionar problemas de outros repositórios, clique ao lado do nome do repositório e selecione um repositório diferente.

Trabalhando com subtarefas usando GitHub CLI

A GitHub CLI é uma ferramenta de código aberto para uso do GitHub na linha de comando do computador. Quando você está trabalhando na linha de comando, você pode usar GitHub CLI para economizar tempo e evitar mudar o contexto. Para saber mais sobre GitHub CLI, consulte Sobre GitHub CLI.

Para criar um novo item como subitem de um item pai existente, use a flag --parent com gh issue create. O pai pode ser especificado por número de problema ou URL.

gh issue create --title "TITLE" --body "ISSUE-DESCRIPTION" --parent PARENT-ISSUE-NUMBER

Para adicionar itens existentes como subitens de um item pai, use a opção --add-sub-issue com gh issue edit. O sinalizador aceita uma lista separada por vírgulas de números de problema ou URLs.

gh issue edit PARENT-ISSUE-NUMBER --add-sub-issue SUB-ISSUE-NUMBER

Para remover um subitem do item pai, use --remove-sub-issue no item pai ou --remove-parent no subitem.

gh issue edit PARENT-ISSUE-NUMBER --remove-sub-issue SUB-ISSUE-NUMBER
gh issue edit SUB-ISSUE-NUMBER --remove-parent