Sobre as listas de tarefas

Sobre as listas de tarefas

As listas de tarefas adicionam suporte para hierarquias de problemas no GitHub, 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.

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

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 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. 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.

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 .

   

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 .

   

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.

   

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

   

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 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 .

   

2. No menu, clique em Copiar markdown.