Skip to main 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 de listas de tarefas foram descontinuado. Leia mais sobre isso no Blog do GitHub.

Você pode usar issues secundários como substituição para blocos de listas 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 Markdown para criar uma lista de tarefas em qualquer comentário em GitHub. Se você fizer referência a um problema, pull request ou discussão em uma lista de tarefas, a referência será expandida 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 ajudar você a acompanhar o trabalho da sua equipe em um issue, o progresso da lista de tarefas de um issue aparece em vários lugares no GitHub como, por exemplo, em uma lista de issues 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 rastreamento ou discussão, você poderá convertê-la em um problema, passando o mouse sobre a tarefa e clicando em 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 do GitHub mostrando duas tarefas em uma lista de tarefas. Uma grade de seis pontos à esquerda da segunda tarefa está contornada em laranja escuro.

Converter tarefas em problemas

Você também pode converter as tarefas em problemas. Primeiro, passe o mouse sobre um dos itens de sua 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.