Skip to main content

Sobre as listas de tarefas

Você pode usar listas de tarefas para dividir o trabalho de um issue ou pull request em tarefas menores e, em seguida, rastrear o conjunto completo de trabalho a ser concluído.

Quem pode usar esse recurso?

O Markdown pode ser usado na interface Web do GitHub.

Sobre as listas de tarefas

Importante

As listas de tarefas foram descontinuado. Você pode ler mais sobre isso no Blog do GitHub.

Você pode usar issues secundários como substituição para blocos de listas de tarefas. Issues 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 issues secundários, confira Como adicionar subproblemas.

Uma lista de tarefas é um conjunto de tarefas que cada uma interpreta em uma linha separada com 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 issue, pull request ou discussão em uma lista de tarefas, a referência será desenrolada para mostrar o título e o estado.

Sobre listas de tarefas do issue

Se você adicionar uma lista de tarefas ao texto de um issue, isso significa que a lista adicionou a 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 issues referenciados na lista de tarefas especificarão que são rastreados no issue de referência.

Captura de tela de um issue mostrando uma lista de tarefas no cabeçalho "Features". 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 issues em issues fechados nem issues com pull requests 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 issue 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 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 issues referenciados em uma lista de tarefas especificam que são acompanhados pelo issue que contém a 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 "Open" e o texto "Tracked by issue #2", que está contornado em laranja.