À propos des listes de tâches

Vous pouvez utiliser des listes de tâches pour interrompre le travail d’un problème ou d’une demande de tirage (pull request) dans des tâches plus petites, puis suivre l’ensemble complet du travail jusqu’à la fin.

Qui peut utiliser cette fonctionnalité ?

Markdown peut être utilisé dans l’interface web GitHub.

Dans cet article

À propos des listes de tâches

Une liste de tâches est un ensemble de tâches qui s’affichent sur une ligne distincte avec une case à cocher cliquable. Vous pouvez sélectionner ou désélectionner les cases à cocher pour marquer les tâches comme terminées ou non terminées.

Vous pouvez utiliser Markdown pour créer une liste de tâches dans n’importe quel commentaire sur GitHub. Si vous référencez un problème, une demande de tirage ou une discussion dans une liste de tâches, la référence se déploie pour en afficher le titre et l’état.

À propos des listes de tâches ayant trait à un problème

Si vous ajoutez une liste de tâches au corps d’un problème, cette liste dispose de plus de fonctionnalités.

  • Pour vous aider à suivre le travail de votre équipe sur un problème, la progression de la liste des tâches correspondante apparaît à différents endroits sur GitHub, comme la liste des problèmes d’un référentiel.
  • Si une tâche fait référence à un autre problème et qu’une personne ferme ce problème, la case à cocher de cette tâche est automatiquement marquée comme terminée.
  • Si une tâche nécessite une discussion ou un suivi plus approfondi, vous pouvez la convertir en problème en la survolant et en cliquant sur dans le coin supérieur droit de cette tâche. Pour ajouter plus de détails avant de créer le problème, vous pouvez utiliser des raccourcis clavier afin d’ouvrir le nouveau formulaire de problème. Pour plus d’informations, consultez « Raccourcis clavier ».
  • Tous les problèmes référencés dans la liste de tâches indiquent qu’ils sont suivis dans le problème de référence.

Capture d’écran d’un problème GitHub montrant une liste de tâches sous l’en-tête « Fonctionnalités ». Certains éléments sont cochés comme terminés, d’autres décochés comme étant annulés. Trois éléments de liste sont liés à d’autres GitHub Issues.

Création de listes de tâches

Pour créer une liste de tâches, faites précéder les éléments de la liste d’un trait d’union et d’un espace, puis de [ ]. Pour marquer une tâche comme terminée, utilisez [x].

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

Capture d’écran montrant la version affichée du markdown. Les références aux problèmes sont affichées sous forme de titres de problème.

Tip

Vous ne pouvez pas créer d’éléments de liste de tâches pour des problèmes fermés ou des problèmes associés à des demandes de tirage.

Réorganisation des tâches

Vous pouvez réorganiser les éléments d’une liste de tâches. Tout d’abord, cliquez ou pointez à gauche de la case à cocher d’une tâche jusqu’à ce qu’une grille de six points s’affiche. Ensuite, faites glisser et déposez la grille pour déplacer la tâche vers un nouvel emplacement.

Vous pouvez réorganiser les tâches de différentes listes dans le même commentaire, mais vous ne pouvez pas réorganiser les tâches entre différents commentaires.

Capture d’écran d’un problème GitHub montrant deux tâches dans une liste de tâches. Une grille de six points à gauche de la deuxième tâche est délimitée en orange foncé.

Conversion de tâches en problèmes

Vous pouvez convertir des tâches en problèmes. Tout d’abord, survolez l’un des éléments de votre liste de tâches et cliquez sur .

Capture d’écran d’un problème GitHub montrant deux tâches. L’icône « Convertir en problème » est mise en évidence avec un encadré orange.

Tous les problèmes référencés dans une liste de tâches indiquent qu’ils sont suivis par le problème qui contient la liste des tâches. Pour accéder au problème de suivi depuis le problème suivi, cliquez sur le numéro du problème de suivi dans la section Suivi dans en regard de l’état du problème.

Capture d’écran d’un problème GitHub nommé « Créer des relations entre les problèmes » avec le numéro 3. Un bouton sous le titre du problème intitulé « Suivi par le problème n° 2 » est délimité en orange foncé.

Pour aller plus loin