Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais atualizadas, acesse a documentação em inglês.
All products
Problemas do GitHub

Sobre as listas de tarefas

Neste artigo

Use listas de tarefas para dividir os problemas em subtarefas menores.

Observação: as listas de tarefas e os campos de acompanhamentos e acompanhado por dos Projetos, no momento, estão na versão beta privada e sujeitos a alterações. Caso tenha interesse em experimentar as listas de tarefas e usar os novos campos, entre na lista de espera.

Sobre as listas de tarefas

As listas de tarefas adicionam suporte para hierarquias de problemas no GitHub Enterprise Cloud, ajudando você a acompanhar os problemas, dividi-los em subtarefas menores e criar relações entre os problemas.

As listas de tarefas se baseiam na iteração anterior das listas de tarefas da versão beta, mantendo a capacidade de converter itens em problemas, exibir o progresso de uma lista de tarefas e criar uma relação "acompanhamentos/acompanhado por" entre problemas.

Os problemas que você adicionar às listas de tarefas serão preenchidos automaticamente para mostrar os destinatários e os rótulos aplicados.

Duas perspectivas do mesmo problema. Em uma delas, o corpo está sendo editado para incluir o Markdown para as listas de tarefas. Na outra, o corpo inclui listas de tarefas renderizadas.

Sobre a integração com o projects

O painel lateral do projeto exibe o local de um problema na hierarquia em um menu estrutural, permitindo que você navegue pelos problemas incluídos nas listas de tarefas. Você também pode adicionar os campos "Acompanhamentos" e "Acompanhados por" às exibições do projeto para ver rapidamente as relações entre os problemas. Para obter mais informações, confira "Sobre os campos Acompanhamentos e Acompanhado por".

Como criar listas de tarefas com o Markdown

Nota: se o GitHub Enterprise Cloud não puder renderizar a lista de tarefas, verifique se ela está formatada como o exemplo abaixo.

Atualmente, as listas de tarefas não dão suporte a:

  • Tarefas recuadas.
  • Novas linhas extras entre ou após a lista de tarefas.

Crie uma lista de tarefas usando o Markdown na descrição do problema (o comentário de abertura de um problema). Você pode incluir links para problemas e solicitações de pull ou criar de problemas de rascunho.

  1. Comece criando um problema ou edite a descrição de um problema existente.
  2. Para iniciar lista de tarefas, digite ```[tasklist] (três acentos graves e tasklist entre colchetes) em uma nova linha na descrição do problema.
  3. Opcionalmente, digite ### TITLE na próxima linha, substituindo TITLE por um título para a lista de tarefas.
  4. Para cada item que deseja adicionar à lista de tarefas, digite - [ ] em uma nova linha, seguido de um espaço e um link para um problema, um link para uma solicitação de pull ou um texto para criar um problema de rascunho.
    • Você precisa fornecer um link completo para um problema ou uma solicitação de pull. Por exemplo, https://github.com/octo-org/octo-repo/issues/45.
    • As tarefas podem ser formatadas com Markdown.
    • As tarefas não devem exceder 256 caracteres de comprimento.
  5. Para concluir a lista de tarefas, digite ``` em uma nova linha após o último item.

A lista de tarefas concluída deverá ter esta aparência:

```[tasklist]
### My tasks
- [ ] https://github.com/octo-org/octo-repo/issues/45
- [ ] Draft issue title
```

A lista de tarefas será renderizada pelo GitHub Enterprise Cloud quando você salvar o problema. Depois você poderá fazer alterações e adicionar problemas e problemas de rascunho usando a interface do usuário do GitHub Enterprise Cloud. Se você editar a descrição do problema, poderá modificar o Markdown diretamente ou copiá-lo para duplicar a lista de tarefas em outros problemas.

Clique também em na barra de ferramentas de formatação para inserir uma lista de tarefas ao criar um problema ou editar a descrição de um problema.

Captura de tela do formulário de um novo problema. Na barra de ferramentas de formatação, há um ícone de lista de verificação com o contorno em laranja escuro.

Como adicionar problemas a uma lista de tarefas

  1. Na parte inferior da lista de tarefas, clique em Adicionar item a Tarefas.

  2. Selecione o problema a ser adicionado à lista de tarefas.

    • Para adicionar um problema atualizado recentemente do repositório, clique nele na lista suspensa ou use as teclas de direção para selecioná-lo e pressione Enter.
    • Para procurar um problema no repositório, comece a digitar o título de um problema ou o número do problema e clique no resultado ou use as teclas de direção para selecioná-lo e pressione Enter.
    • Para adicionar um problema diretamente usando a própria URL, cole a URL de um problema e pressione Enter.

Como criar problemas de rascunho em uma lista de tarefas

Problemas de rascunho são úteis para capturar rapidamente ideias que você pode converter em problemas mais tarde. Ao contrário das solicitações de pull e dos problemas referenciados nos repositórios, os problemas de rascunho só existem na lista de tarefas.

  1. Na parte inferior da lista de tarefas, clique em Adicionar item a Tarefas.
  2. No campo "Digite para adicionar um item ou cole uma URL de problema", digite o título do problema de rascunho e pressione Enter.

Como converter problemas de rascunho em problemas em uma lista de tarefas

Você pode converter problemas de rascunhos em problemas. Os problemas são criados no mesmo repositório do problema pai da lista de tarefas.

  1. Ao lado do problema de rascunho que você deseja converter, clique em .

    Captura de tela de uma lista de tarefas. À direita de uma tarefa, o menu de itens do bloco de rastreamento, rotulado com um ícone de kebab horizontal, tem o contorno em laranja escuro.

  2. No menu, clique em Converter em problema.

Como remover um problema ou um problema de rascunho de uma lista de tarefas

Você pode remover problemas e problemas de rascunho da lista de tarefas. Os problemas removidos de uma lista de tarefas não são removidos do repositório.

  1. Ao lado do problema de rascunho que você deseja remover, clique em .

    Captura de tela de uma lista de tarefas. À direita de uma tarefa, o menu de itens do bloco de rastreamento, rotulado com um ícone de kebab horizontal, tem o contorno em laranja escuro.

  2. No menu, clique em Remover.

Como alterar o título de uma lista de tarefas

Quando você cria uma lista de tarefas, o título padrão é "Tarefas". Você pode modificar o título editando o markdown do problema.

  1. No canto superior direito do corpo do problema, selecione e clique em Editar.

    Captura de tela do cabeçalho de um comentário de problema. No canto direito, há um ícone de kebab horizontal com o contorno em laranja escuro.

  2. No bloco de código cercado que começa com ```[tasklist], add a header with your new title, such as ## My new title.

    Captura de tela de um comentário de problema no modo de edição. Abaixo da linha que diz "```tasklist", há uma linha que diz "## My new title" com o contorno em laranja escuro.

  3. Clique em Atualizar comentário.

Como copiar uma lista de tarefas

Quando você copia a lista de tarefas usando a opção "Copiar Markdown", o GitHub Enterprise Cloud copia o Markdown para a área de transferência e inclui o nome do problema para que você possa colar a lista de tarefas fora do GitHub sem perder o contexto.

  1. No canto superior direito da lista de tarefas, clique em .

    Captura de tela de uma lista de tarefas. O menu de itens do bloco de rastreamento, rotulado com um ícone de kebab horizontal, tem o contorno em laranja escuro.

  2. No menu, clique em Copiar markdown.