À propos des listes de tâches

À propos des listes de tâches

Les listes de tâches prennent en charge les hiérarchies de problèmes sur GitHub Enterprise Cloud pour vous aider à suivre vos problèmes, à les diviser en sous-tâches et à créer des relations entre eux.

Les listes de tâches s’appuient sur l’itération précédente des listes de tâches en version bêta et prennent toujours en charge la conversion d’éléments en problèmes, l’affichage de la progression d’une liste de tâches et la création d’une relation « suivis/suivi par » entre les problèmes.

Les problèmes que vous ajoutez à vos listes de tâches sont automatiquement renseignés avec les personnes responsables et les étiquettes appliquées.

À propos de l’intégration à projects

Le panneau latéral de votre projet affiche la place d’un problème dans la hiérarchie dans un menu de navigation, ce qui vous permet de parcourir les problèmes inclus dans vos listes de tâches. Vous pouvez également ajouter les champs Suivis et Suivi par à vos vues de projet pour voir rapidement les relations entre vos problèmes. Pour plus d’informations, consultez « À propos des champs Suivis et Suivi par ».

Création de listes de tâches avec Markdown

Vous pouvez créer une liste de tâches en utilisant Markdown dans la description du problème (commentaire d’ouverture d’un problème). Vous pouvez ajouter des liens vers des problèmes et des demandes de tirage, ou créer des brouillons de problème.

1. Commencez à créer un problème ou modifiez la description d’un problème existant.
2. Pour commencer votre liste de tâches, tapez ```[tasklist] (trois accents graves et tasklist entre crochets) sur une nouvelle ligne dans la description du problème.
3. Vous pouvez aussi taper ### TITLE sur la ligne suivante, en remplaçant TITLE par un titre pour votre liste de tâches.
4. Pour chaque élément que vous souhaitez ajouter à votre liste de tâches, tapez - [ ] sur une nouvelle ligne, suivi d’un espace, et un lien vers un problème ou un lien vers une demande de tirage ou du texte pour créer un brouillon de problème.
   • Vous devez fournir un lien complet vers un problème ou une demande de tirage. Par exemple : https://github.com/octo-org/octo-repo/issues/45.
   • Les tâches peuvent être mises en forme avec Markdown.
   • Les tâches ne doivent pas dépasser 256 caractères.
5. Pour terminer votre liste de tâches, tapez ``` sur une nouvelle ligne après le dernier élément.

Votre liste de tâches finie doit ressembler à cet exemple :

```[tasklist]
### My tasks
- [ ] https://github.com/octo-org/octo-repo/issues/45
- [ ] Draft issue title
```

Votre liste de tâches est affichée par GitHub Enterprise Cloud quand vous enregistrez le problème. Vous pouvez ensuite faire des changements, et ajouter des problèmes et des brouillons de problème en utilisant l’interface utilisateur GitHub Enterprise Cloud. Si vous modifiez la description du problème, vous pouvez modifier le Markdown directement ou le copier pour dupliquer la liste de tâches dans d’autres problèmes.

Vous pouvez également cliquer sur dans la barre d’outils de mise en forme pour insérer une liste de tâches quand vous créez un problème ou modifiez une description de problème.

Ajout de problèmes à une liste de tâches

1. En bas de votre liste de tâches, cliquez sur Ajouter un élément aux tâches.

2. Sélectionnez le problème à ajouter à votre liste de tâches.

   • Pour ajouter un problème récemment mis à jour à partir du dépôt, cliquez sur le problème dans le menu déroulant ou utilisez les touches de direction pour le sélectionner, puis appuyez sur Entrée.
   • Pour rechercher un problème dans le dépôt, commencez à taper le titre d’un problème ou le numéro du problème et cliquez sur le résultat. Vous pouvez également utiliser les touches de direction pour sélectionner le problème et appuyer sur Entrée.
   • Pour ajouter un problème directement à l’aide de son URL, collez l’URL d’un problème et appuyez sur Entrée.

Créer des brouillons de problème dans une liste de tâches

Les brouillons de problèmes sont utiles pour capturer rapidement des idées que vous pouvez convertir par la suite en problèmes. Contrairement aux problèmes et aux demandes de tirage référencés à partir de vos dépôts, les brouillons de problème existent seulement dans votre liste de tâches.

1. En bas de votre liste de tâches, cliquez sur Ajouter un élément aux tâches.
2. Dans le champ « Tapez pour ajouter un élément ou le coller dans une URL de problème », tapez le titre de votre brouillon de problème et appuyez sur Entrée.

Conversion de brouillons de problème en problèmes dans une liste de tâches

Vous pouvez convertir des brouillons de problèmes en problèmes. Les problèmes sont créés dans le même dépôt que le problème parent de la liste de tâches.

1. À côté du brouillon de problème que vous souhaitez convertir, cliquez sur .

   

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

Suppression d’un problème ou d’un brouillon de problème d’une liste de tâches

Vous pouvez supprimer des problèmes et des brouillons de problème de votre liste de tâches. Les problèmes supprimés d’une liste de tâches ne sont pas supprimés du dépôt.

1. À côté du brouillon de problème que vous souhaitez supprimer, sélectionnez .

   

2. Dans le menu, cliquez sur Supprimer.

Changement du titre d’une liste de tâches

Quand vous créez une liste de tâches, le titre par défaut est « Tâches ». Vous pouvez changer le titre en modifiant le Markdown du problème.

1. En haut à droit du corps du problème, sélectionnez et cliquez sur Modifier.

   

2. Dans le bloc de code délimité qui commence par ```[tasklist], add a header with your new title, such as ## My new title.

   

3. Cliquez sur Mettre à jour le commentaire.

Copie d’une liste de tâches

Quand vous copiez votre liste de tâches en utilisant l’option « Copier le Markdown », GitHub Enterprise Cloud copie le Markdown dans le Presse-papiers et ajoute le nom du problème pour vous permettre de coller la liste de tâches en dehors de GitHub sans perdre le contexte.

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

   

2. Dans le menu, cliquez sur Copier le Markdown.