Ajout de sous-problèmes

Découvrez comment utiliser les sous-problèmes pour décomposer votre travail en tâches.

Qui peut utiliser cette fonctionnalité ?

People with at least triage permissions for a repository can add sub-issues.

Dans cet article

Vous pouvez ajouter des sous-problèmes à un problème pour diviser les plus gros éléments de travail en tâches. Vos sous-problèmes montrent leur relation avec le problème parent, ce qui vous permet de suivre votre travail à travers GitHub. Les problèmes parents et la progression des sous-problèmes sont également disponibles dans votre projets, ce qui vous permet de générer des vues, filtrer et regrouper par problème parent.

Vos sous-problèmes peuvent eux-mêmes contenir des sous-problèmes, ce qui vous permet de créer des hiérarchies complètes de problèmes qui représentent des projets ou des éléments de travail entiers et affichent les relations entre vos problèmes.

Vous pouvez ajouter jusqu’à 100 des sous-problèmes par problème parent et créer jusqu’à huit niveaux de sous-problèmes imbriqués.

Création d’un sous-problème

  1. Accédez au problème pour lequel vous souhaitez ajouter un sous-problème.
  2. En bas de la description du problème, cliquez sur Créer un sous-problème.
  3. Dans la boîte de dialogue, entrez le titre de votre sous-problème.
  4. Si vous le souhaitez, tapez la description de votre problème et définissez le type de problème et tous les assigneurs, étiquettes, projets et jalons.
  5. Éventuellement, si vous souhaitez continuer à créer des sous-problèmes pour ce problème parent, sélectionnez Créer d’autres sous-problèmes.
  6. Cliquez sur Créer.

Ajout d’un problème existant comme sous-problème

  1. Accédez au problème pour lequel vous souhaitez ajouter un sous-problème.

  2. En bas de la description du problème, à côté de « Créer un sous-problème », cliquez sur .

    Capture d’écran de la section Sous-problèmes sous la description du problème. Le bouton « Afficher plus d’options de sous-problème » est mis en évidence avec un encadré orange.

  3. Dans le menu déroulant, cliquez sur Ajouter un problème existant.

  4. Sélectionnez le problème que vous souhaitez ajouter comme sous-problème.

    • Sélectionnez un problème parmi les suggestions.
    • Dans le champ « Rechercher des problèmes », entrez un titre de problème ou un numéro de problème, puis cliquez sur les résultats.
    • Pour ajouter des problèmes à partir d’autres référentiels, cliquez en regard du nom du référentiel et sélectionnez un autre référentiel.

Utilisation de sous-problèmes à l’aide de GitHub CLI

GitHub CLI est un outil open source permettant d’utiliser GitHub à partir de la ligne de commande de votre ordinateur. Lorsque vous travaillez à partir de la ligne de commande, vous pouvez utiliser l’GitHub CLI pour gagner du temps et éviter de changer de contexte. Pour en savoir plus sur GitHub CLI, consultez À propos de l’interface CLI GitHub.

Pour créer un problème en tant que sous-problème d’un parent existant, utilisez l’indicateur --parent avec gh issue create. Le parent peut être spécifié par numéro de problème ou URL.

gh issue create --title "TITLE" --body "ISSUE-DESCRIPTION" --parent PARENT-ISSUE-NUMBER

Pour ajouter des problèmes existants en tant que sous-problèmes d’un parent, utilisez l’indicateur --add-sub-issue avec gh issue edit. L’indicateur accepte une liste de numéros de tickets ou d’URL, séparés par des virgules.

gh issue edit PARENT-ISSUE-NUMBER --add-sub-issue SUB-ISSUE-NUMBER

Pour supprimer un sous-problème de son parent, utilisez --remove-sub-issue sur le parent ou --remove-parent sur le sous-problème.

gh issue edit PARENT-ISSUE-NUMBER --remove-sub-issue SUB-ISSUE-NUMBER
gh issue edit SUB-ISSUE-NUMBER --remove-parent