Skip to main content

Como criar uma lista de tarefas

Você pode criar uma lista de tarefas usando a interface do usuário do GitHub ou o Markdown.

Observação: as listas de tarefas estão em versão beta privada e sujeitas a alterações. No momento, pausamos a integração para o beta.

Como criar listas de tarefas na interface do usuário

Use o botão Adicionar lista de tarefas para adicionar rapidamente uma lista de tarefas ao problema. O botão Adicionar lista de tarefas está disponível quando você visualiza ou edita um problema.

  1. Navegue até o problema o qual deseja que contenha a nova lista de tarefas. Você também pode criar um problema.

  2. Na parte inferior da descrição do problema, clique em Adicionar lista de tarefas.

    Captura de tela de um problema. O botão "Adicionar lista de tarefas" é realçado com um contorno laranja.

  3. Em seguida, você pode adicionar problemas, pull requests e tarefas de rascunho à nova lista de tarefas. Para obter mais informações, confira "Como gerenciar tarefas em uma lista de tarefas".

Como criar listas de tarefas com o Markdown

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

Você pode adicionar uma lista de tarefas copiando o Markdown abaixo na descrição do problema:

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

Use também o botão Adicionar lista de tarefas ao editar o problema para inserir o Markdown para uma lista de tarefas:

Captura de tela de um problema. O botão "Adicionar lista de tarefas" é realçado com um contorno laranja.

Depois de começar a editar o Markdown da lista de tarefas, você poderá adicionar novas tarefas precedendo cada nova tarefa com - [ ] e, em seguida, adicionando:

  • Uma tarefa de rascunho. Tarefas de rascunho são textos que podem ser convertidos posteriormente em problemas.
  • O link completo de um problema ou uma solicitação de pull. Por exemplo, https://github.com/octo-org/octo-repo/issues/45. Se um problema ou uma solicitação de pull estiver no mesmo repositório que a lista de tarefas, você poderá usar a sintaxe abreviada #ISSUE-NUMBER. Por exemplo, #45.

Se você adicionar uma tarefa de rascunho, ela precisará atender a estes requisitos:

  • As tarefas de rascunho podem ser formatadas usando o Markdown.
  • As tarefas de rascunho não devem exceder 512 caracteres.

A lista de tarefas será renderizada pelo GitHub quando você visualizar as alterações e quando salvar o problema. Depois, você poderá fazer alterações e adicionar problemas e tarefas 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.

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 clicando em Renomear no menu de contexto da lista de tarefas ou 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 isolado 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 indica "```tasklist", uma linha que indica "## My new title" é realçada 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 copia o Markdown para a área de transferência e inclui o título do problema para que você possa colar a lista de tarefas fora do GitHub sem perder o contexto. Veja abaixo um exemplo de uma lista de tarefas do Markdown copiada:

- [x] [Design new landing page](https://github.com/octocat/octoproject/issues/4)
- [ ] [Translate content into supported languages](https://github.com/octocat/octoproject/issues/11)
  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.