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.
-
Navegue até o problema o qual deseja que contenha a nova lista de tarefas. Você também pode criar um problema.
-
Na parte inferior da descrição do problema, clique em Adicionar lista de tarefas.
-
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:
```[tasklist] ### My tasks - [ ] https://github.com/octo-org/octo-repo/issues/45 - [ ] Draft task ```
```[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:
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 Enterprise Cloud 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 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.
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.
-
No canto superior direito do corpo do problema, selecione e clique em Editar.
-
No bloco de código isolado que começa com
```[tasklist]
, adicione um cabeçalho com seu novo título, como### My new title
. -
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 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)
-
No canto superior direito da lista de tarefas, clique em .
-
No menu, clique em Copiar markdown.