Skip to main content
Skip to content

Sobre as listas de tarefas

Você pode usar listas de tarefas para dividir o trabalho de um problema ou pull request em tarefas menores e, em seguida, fazer o rastreamento de todo o trabalho até a conclusão.

Quem pode usar esse recurso?

O Markdown pode ser usado na interface Web do GitHub.

Sobre as listas de tarefas

Importante

Os blocos da lista de tarefas são Aposentado. Você pode ler mais sobre isso no GitHub Blog.

Você pode usar subitens em vez de blocos de lista de tarefas. Problemas secundários fornecem uma seção dedicada em cada issue, facilitando o acompanhamento do trabalho relacionado sem depender do Markdown. Para obter mais informações sobre subproblemas, consulte Como adicionar subproblemas.

Uma lista de tarefas é um conjunto de tarefas onde cada tarefa é renderizada em uma linha separada, acompanhada por uma caixa de seleção clicável. Você pode selecionar ou desmarcar as caixas de seleção para marcar as tarefas como concluídas ou não concluídas.

Você pode usar o Markdown para criar uma lista de tarefas em qualquer comentário.GitHub Se você fizer referência a um problema, solicitação pull ou discussão em uma lista de tarefas, a referência será desenrolada para mostrar o título e o estado.

Sobre as listas de tarefas do problema

Se você adicionar uma lista de tarefas ao texto de um problema, isso significa que a lista adicionou funcionalidade.

  • Para ajudá-lo a acompanhar o trabalho de sua equipe em um problema, o progresso da lista de tarefas de um problema aparece em vários locais GitHub, como a lista de problemas de um repositório.
  • Se uma tarefa fizer referência a outro problema e alguém fechar esse problema, a caixa de seleção da tarefa será automaticamente marcada como concluída.
  • Se uma tarefa exigir mais acompanhamento ou discussão, você poderá converter a tarefa em um problema passando o mouse sobre a tarefa e clicando no canto superior direito da tarefa. Para adicionar mais detalhes antes de criar o problema, você pode usar atalhos de teclado para abrir o formulário do novo problema. Para saber mais, confira Atalhos do teclado.
  • Quaisquer problemas referenciados na lista de tarefas especificarão que são rastreados no problema de referência.

Captura de tela de um problema mostrando uma lista de tarefas no cabeçalho "Recursos". Três itens da lista vinculam a outros problemas.

Criando listas de tarefas

Para criar uma lista de tarefas, coloque um hífen e um espaço seguidos de [ ] antes dos itens de lista. Para marcar uma tarefa como concluída, use [x].

- [x] #739
- [ ] https://github.com/octo-org/octo-repo/issues/740
- [ ] Add delight to the experience when all tasks are complete :tada:

Captura de tela mostrando a versão renderizada do markdown. As referências a problemas são renderizadas como títulos de problema.

Observação

Você não pode criar itens de lista de tarefas em problemas fechados ou problemas com solicitações de pull vinculadas.

Reordenar tarefas

Você pode reordenar os itens em uma lista de tarefas. Primeiro, clique ou passe o mouse à esquerda da caixa de seleção de uma tarefa até que uma grade de seis pontos seja exibida. Em seguida, arraste e solte a grade para mover a tarefa para um novo local.

Você pode reordenar tarefas em diferentes listas no mesmo comentário, mas não pode reordenar tarefas em diferentes comentários.

Captura de tela de um problema GitHub mostrando duas tarefas em uma lista de tarefas. Uma grade de seis pontos à esquerda da segunda tarefa é descrita em laranja escuro.

Converter tarefas em problemas

Você também pode converter as tarefas em problemas. Primeiro, passe o mouse sobre um dos itens da lista de tarefas e clique em .

Captura de tela de um problema mostrando duas tarefas. O ícone "Convert to issue" está realçado com um contorno laranja.

Todos os problemas referenciados em uma lista de tarefas indicam que estão sendo monitorados pelo problema que contém essa lista de tarefas. Para acessar o problema de rastreamento desde o problema rastreado, clique no número de rastreamento na seção Tracked by ao lado do status do problema.

Captura de tela do problema 3 mostrando o status "Abrir" e o texto "Rastreado pelo problema #2", que está contornado em laranja.