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 subproblemas mostram o relacionamento deles com o problema pai permitindo que você acompanhe seu trabalho no GitHub. O progresso dos problemas pai e dos subproblemas também está disponível no seu projetos, permitindo que você crie exibições, filtre e agrupe por problema 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 subproblemas por problema pai e criar até oito níveis de subproblemas 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.

Trabalhar com subproblemas 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 problema como subproblema de um pai existente, use o sinalizador --parent com gh issue create. O pai pode ser especificado por número ou URL do problema.

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

Para adicionar problemas existentes como subproblemas de um pai, use o sinalizador --add-sub-issue com gh issue edit. O sinalizador aceita uma lista separada por vírgulas de números de problemas ou URLs.

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

Para remover um subproblema de seu pai, use --remove-sub-issue no pai ou --remove-parent no subproblema.

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