Démarrage rapide pour les listes de tâches

Introduction

Ce guide montre comment utiliser des listes de tâches pour décomposer un élément de travail conséquent en plusieurs listes de tâches et sous-tâches. Vous allez apprendre à créer une liste de tâches à l’aide de l’interface utilisateur, à créer une liste de tâches à l’aide de Markdown, à apporter des modifications à une liste de tâches et à intégrer vos nouvelles listes de tâches à un projet.

Pour montrer comment les listes de tâches peuvent être utilisées pour diviser le travail en sous-tâches plus petites, ce guide suit un scénario dans lequel nous devons créer une page d’accueil pour une nouvelle fonctionnalité. N’hésitez pas à suivre ce guide, mais en y incorporant votre propre scénario.

Prérequis

En suivant ce guide, vous allez créer plusieurs problèmes dans un dépôt. Vous avez besoin d’un dépôt dans lequel vous pouvez créer des problèmes.

Création d’un problème pour suivre le travail d’ajout d’une nouvelle page d’accueil

Dans cette étape, nous allons créer le problème parent pour suivre les sous-tâches nécessaires à la publication de la nouvelle page d’accueil.

1. Accédez au dépôt dans lequel vous souhaitez suivre le travail.
2. Créez un problème vide avec le titre « Problème de suivi pour la page d’accueil ». Pour plus d’informations, consultez « Création d’un problème ».

Création de la première liste de tâches

Les listes de tâches sont ajoutées au commentaire d’ouverture d’un problème (description du problème). Les problèmes peuvent contenir plusieurs listes de tâches avec des titres différents. C’est un excellent moyen de catégoriser vos sous-tâches.

1. Accédez au problème que vous venez de créer. Si vous ne l’avez pas déjà fait, appuyez sur Envoyer un nouveau problème.
2. En bas de la description du problème, cliquez sur Ajouter une liste de tâches.

Cette opération insère une liste de tâches vide dans votre problème.

Ajout de brouillons de tâche

Les brouillons de tâche sont des éléments de texte qui sont ajoutés à votre liste de tâches. Les brouillons de tâche apparaissent dans votre liste de tâches avec une case à cocher. Vous pouvez utiliser des brouillons de tâche pour ébaucher rapidement les besoins et les sous-tâches pour votre projet et, éventuellement, les convertir plus tard en problèmes.

1. Si le champ de texte n’est pas déjà ciblé, cliquez sur Ajouter un élément aux tâches.

   

2. Ajoutez des brouillons de tâche pour ébaucher ce travail. Rédigez vos brouillons de tâche et appuyez sur Entrée après chacun d’eux.

   Pour notre exemple de scénario de page d’accueil, vous pouvez ajouter :

   • « Concevoir une nouvelle page d’accueil »
   • « Créer du contenu pour la page d’accueil »
   • « Traduire le contenu dans des langues prises en charge »

Conversion d’un brouillon de tâche en problème

Vous pouvez convertir vos brouillons de tâche en problèmes. Vous pouvez convertir des brouillons de tâche lorsque vous êtes prêt à commencer à travailler sur une tâche en particulier. Les problèmes sont créés dans le même dépôt que celui que vous avez utilisé pour votre problème de suivi.

1. À côté du brouillon de tâche « Concevoir une nouvelle page d’accueil », cliquez sur .

   

2. Dans le menu, cliquez sur Convertir en problème.

Vous assigner le nouveau problème

Vous pouvez maintenant vous assigner le nouveau problème sans quitter votre liste de tâches.

1. À côté du problème « Concevoir une nouvelle page d’accueil » de votre liste de tâches, cliquez sur .

   

2. Dans le menu contextuel, cliquez sur Définir les destinataires.

3. Dans la liste des personnes, sélectionnez-vous.

Vous pouvez également utiliser ce menu contextuel pour définir des étiquettes et ajouter un problème à un projet.

Renommage d’une liste de tâches

Vous pouvez changer le titre d’une liste de tâches pour mieux représenter les tâches qu’elle suit. C’est particulièrement utile lorsque vous avez plusieurs listes de tâches dans le même problème et que vous souhaitez segmenter vos tâches.

1. En haut à droite de votre liste de tâches, cliquez sur .

   

2. Dans le menu, cliquez sur Renommer.

3. Tapez un nouveau titre pour votre liste de tâches et appuyez sur Entrée.

   Pour notre exemple de scénario de page d’accueil, vous pouvez renommer cette liste de tâches « Contenu de la page d’accueil ».

Création d’une seconde liste de tâches à l’aide de Markdown

Vous pouvez créer plusieurs listes de tâches dans un seul problème. Chaque liste de tâches a ses propres tâches et son propre titre. Vous pouvez ajouter des listes de tâches à l’aide du bouton Ajouter une liste de tâches ou en entrant Markdown lorsque vous modifiez le problème.

1. En haut de la description du problème (le commentaire d’ouverture), cliquez sur .

   

2. Dans le menu, cliquez sur Modifier.

3. Dans la description du problème, sous votre première liste de tâches, ajoutez le code Markdown ci-dessous :

   Markdown

   ```[tasklist]
   ### Tasks
   - [ ] Draft task
   ```
   

4. Pour changer le titre de cette liste de tâches, tapez un nouveau titre après ### . Par exemple, remplacez ### Tasks par ### Backend changes.

Dans les deux sections suivantes, nous allons apporter d’autres modifications au code Markdown avant d’enregistrer le commentaire.

Ajout d’un brouillon de tâche à l’aide de Markdown

Vous pouvez rapidement ajouter de nouveaux brouillons de tâche en les tapant directement dans votre liste de tâches à l’aide de Markdown.

1. Ajoutez un nouveau brouillon de tâche en créant une ligne après la dernière tâche, en tapant - [ ] et votre nouvelle tâche. Par exemple : - [ ] Sign-up form.
2. Modifiez un brouillon de tâche existant en modifiant le texte après - [ ]. Par exemple, remplacez - [ ] Draft task par - [ ] Database schema.

Ajout de problèmes existants à l’aide de Markdown

Vous pouvez également suivre les problèmes existants en les ajoutant à votre liste de tâches. Vous pouvez ajouter des problèmes existants à l’aide de Markdown ou dans l’interface utilisateur en collant l’URL du problème. Vous pouvez ajouter des problèmes et des demandes de tirage à partir de n’importe quel dépôt auquel vous avez accès.

1. Commencez à taper - [ ] sur une nouvelle ligne, puis collez l’URL complète d’un problème. Par exemple : - [ ] https://github.com/octo-org/octo-repo/issues/45
2. Cliquez sur Mettre à jour le commentaire.

Vous voyez votre deuxième liste de tâches sous votre première liste de tâches.

Suivi de la progression

Les listes de tâches vous permettent de voir rapidement l’état et la progression des tâches que vous avez choisies de suivre.

1. À gauche de l’un de vos brouillons de tâche, cochez la case pour marquer cette tâche comme étant accomplie.
2. Cliquez sur le problème que vous aviez converti à partir d’un brouillon.
3. Dans le problème converti, en bas de la page, cliquez sur Fermer le problème.

Lorsque vous revenez à votre liste des tâches et actualisez la page, vous pouvez voir que le problème que vous venez de fermer a maintenant une icône indiquant qu’il est effectivement fermé. En haut du problème, sous le titre, la progression indique « 2 tâches sur 6 ».

Intégration dans un projet

Les relations que vous créez dans vos listes de tâches sont disponibles dans vos projets. Vous pouvez rapidement voir la progression de chaque problème, parcourir les sous-tâches et configurer les vues qui utilisent vos listes de tâches.

1. Accédez à un projet appartenant au même compte d’utilisateur ou d’organisation que celui que vous avez utilisé pour votre liste de tâches et vos problèmes. Si vous n’avez pas de projet disponible, vous pouvez en créer un. Pour plus d’informations, consultez « Création d’un project ».

2. Créez une vue dans votre projet en utilisant la disposition de tableau. Pour plus d’informations sur les vues, consultez « Gestion de vos vues ».

3. Ajoutez l’un des problèmes de vos listes de tâches à votre projet. Pour plus d’informations sur l’ajout d’éléments aux projets, consultez « Ajout d’éléments à votre project ».

4. Cliquez sur à côté du nom de la vue actuellement ouverte.

   

5. Dans le menu, cliquez sur Regrouper par, puis sélectionnez Suivi par. Cette opération crée une vue où vos problèmes sont regroupés par le problème qui les suit.

Les problèmes et les demandes de tirage ne sont pas automatiquement ajoutés à un projet lorsqu’ils sont ajoutés à une liste de tâches. Lorsque vous regroupez une vue par le champ « Suivi par », GitHub vous invite à ajouter d’autres problèmes associés à la liste de tâches.

1. S’il existe des problèmes dans vos listes de tâches qui ne font pas partie de votre projet, vous pouvez cliquer sur 1 élément qui n’est pas dans ce projet sous le groupe.

1. Dans la liste des problèmes, cliquez sur le problème que vous souhaitez ajouter. Si vous avez plusieurs problèmes, vous pouvez choisir de les ajouter tous.

Conclusion

Après avoir suivi ce guide, vous avez créé un problème de suivi avec deux listes de tâches, apporté des modifications à ces listes de tâches dans l’interface utilisateur et directement avec Markdown, converti un brouillon de tâche en problème et intégré vos données de liste de tâches dans un projet.

Pour en savoir plus sur la gestion des éléments dans votre liste de tâches, consultez « Gestion des tâches dans une liste de tâches ». Pour plus d’informations sur l’intégration de listes de tâches dans vos projets, consultez « Utilisation de projets et de listes de tâches ».