Skip to main content

Création d’un problème

Les problèmes peuvent être créés de différentes façons. Vous pouvez donc choisir la méthode la plus pratique pour votre workflow.

Qui peut utiliser cette fonctionnalité ?

People with read access can create an issue in a repository where issues are enabled.

Les problèmes peuvent être utilisés pour suivre les bogues, les améliorations ou d’autres demandes. Pour plus d’informations, consultez « À propos des problèmes ».

Les administrateurs de dépôt peuvent désactiver les problèmes liés à un dépôt. Pour plus d’informations, consultez « Désactivation des problèmes ».

Création d’un problème à partir d’un dépôt

  1. Dans GitHub.com, accédez à la page principale du dépôt.

  2. Sous le nom de votre référentiel, cliquez sur Problèmes.

    Capture d’écran de la page principale d’un dépôt. Dans la barre de navigation horizontale, un onglet intitulé « Problèmes » est indiqué en orange foncé.

  3. Cliquez sur Nouveau problème.

  4. Si votre dépôt utilise des modèles de problème, à côté du type de problème que vous souhaitez ouvrir, cliquez sur Démarrer.

    Si le type de problème que vous souhaitez ouvrir n’est pas inclus dans les options disponibles, cliquez sur Ouvrir un problème vide.

    Capture d’écran du sélecteur de modèle pour un problème. Sous les choix du modèle, un lien intitulé « Ouvrir un problème vide » est encadré en orange foncé.

  5. Dans le champ « Titre », tapez un titre pour votre problème.

  6. Dans le champ du corps du commentaire, tapez une description de votre problème.

  7. Si vous êtes mainteneur de projet, vous pouvez affecter le problème à une personne, l’ajouter à un projet (classique), l’associer à un jalon ou appliquer une étiquette.

  8. Lorsque vous avez terminé, cliquez sur Envoyer le nouveau problème.

Création d’un problème avec 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 plus d’informations GitHub CLI, consultez « À propos de GitHub CLI ».

Pour créer un problème, utilisez la sous-commande gh issue create. Pour ignorer les invites interactives, incluez les indicateurs --body et --title.

gh issue create --title "My new issue" --body "Here are more details."

Vous pouvez également spécifier des destinataires, des étiquettes, des jalons et des projets.

gh issue create --title "My new issue" --body "Here are more details." --assignee @me,monalisa --label "bug,help wanted" --project onboarding --milestone "learning codebase"

Création d’un problème à partir d’un commentaire

Vous pouvez ouvrir un nouveau problème à partir d’un commentaire dans un problème ou une demande de tirage. Quand vous ouvrez un problème à partir d’un commentaire, le problème contient un extrait de code indiquant où le commentaire a été initialement publié.

  1. Accédez au commentaire à partir duquel vous souhaitez ouvrir un problème.

  2. Dans ce commentaire, cliquez sur .

    Capture d’écran d’un commentaire sur une demande de tirage. Le bouton des trois points est indiqué en orange foncé.

  3. Cliquez sur Référence dans un nouveau problème.

  4. Utilisez le menu déroulant « Dépôt » et sélectionnez le dépôt dans lequel vous souhaitez ouvrir le problème.

  5. Tapez un titre et un corps descriptifs pour le problème.

  6. Cliquez sur Créer un problème.

  7. Si vous êtes mainteneur de projet, vous pouvez affecter le problème à une personne, l’ajouter à un projet (classique), l’associer à un jalon ou appliquer une étiquette.

  8. Lorsque vous avez terminé, cliquez sur Envoyer le nouveau problème.

Création d’un problème à partir du code

Vous pouvez ouvrir un nouveau problème à partir d’une ou plusieurs lignes de code spécifiques dans un fichier ou une demande de tirage. Quand vous ouvrez un problème à partir du code, le problème contient un extrait indiquant la ligne ou la plage de code que vous avez choisie. Vous ne pouvez ouvrir un problème que dans le même dépôt où le code est stocké.

  1. Dans GitHub.com, accédez à la page principale du dépôt.

  2. Localisez le code que vous souhaitez référencer dans un problème :

    • Pour ouvrir un problème concernant du code dans un fichier, accédez au fichier.
    • Pour ouvrir un problème concernant du code dans une demande de tirage, accédez à la demande de tirage et cliquez sur Fichiers changés. Ensuite, accédez au fichier contenant le code que vous souhaitez inclure dans votre commentaire, puis cliquez sur Afficher.
  3. Choisissez s’il faut sélectionner une seule ligne ou une plage.

    • Pour sélectionner une seule ligne de code, cliquez sur le numéro de la ligne pour mettre celle-ci en surbrillance.
    • Pour sélectionner une plage de code, cliquez sur le numéro de la première ligne de code de la plage pour mettre celle-ci en surbrillance. Pointez ensuite sur la dernière ligne de la plage de code, appuyez sur Maj et cliquez sur le numéro de la ligne pour mettre la plage en surbrillance.
  4. À gauche de la plage de code, cliquez sur . Dans le menu déroulant, cliquez sur Référencer dans le nouveau problème.

    Capture d’écran d’un fichier avec 8 lignes sélectionnées. À gauche de la première ligne sélectionnée, un bouton étiqueté avec une icône de trois points est indiqué en orange foncé.

  5. Dans le champ « Titre », tapez un titre pour votre problème.

  6. Dans le champ du corps du commentaire, tapez une description de votre problème.

  7. Si vous êtes mainteneur de projet, vous pouvez affecter le problème à une personne, l’ajouter à un projet (classique), l’associer à un jalon ou appliquer une étiquette.

  8. Lorsque vous avez terminé, cliquez sur Envoyer le nouveau problème.

Création d’un problème à partir d’une discussion

Les personnes disposant d’une autorisation de triage sur un dépôt peuvent créer un problème à partir d’une discussion.

Quand vous créez un problème à partir d’une discussion, le contenu du billet de discussion est automatiquement inclus dans le corps du problème et toutes les étiquettes sont conservées. La création d’un problème à partir d’une discussion ne convertit pas la discussion en problème et ne supprime pas la discussion existante. Pour plus d’informations sur GitHub Discussions, consultez « À propos des discussions ».

  1. Sous votre dépôt ou nom d’organisation, cliquez sur Discussions.

    Capture d’écran des onglets d’un dépôt GitHub. L’option « Discussions » est présentée en orange foncé.

  2. Dans la liste des discussions, cliquez sur la discussion à afficher.

  3. Dans la barre latérale droite, cliquez sur Créer un problème à partir d’une discussion.

    Capture d’écran de la barre latérale dans une discussion. L’option « Créer un problème à partir d’une discussion » est présentée en orange foncé.

  4. Dans le champ « Titre », tapez un titre pour votre problème.

  5. Dans le champ du corps du commentaire, tapez une description de votre problème.

  6. Si vous êtes mainteneur de projet, vous pouvez affecter le problème à une personne, l’ajouter à un projet (classique), l’associer à un jalon ou appliquer une étiquette.

  7. Lorsque vous avez terminé, cliquez sur Envoyer le nouveau problème.

Création d’un problème à partir d’un projet

Vous pouvez rapidement créer des problèmes sans quitter votre projet. Lors de l’utilisation d’une vue groupée par un champ, la création d’un problème dans ce groupe définit automatiquement le champ du nouveau problème sur la valeur du groupe. Par exemple, si vous regroupez votre vue par « Statut », lorsque vous créez un problème dans le groupe « À faire », le « Statut » du nouveau problème est automatiquement défini sur « À faire ». Pour plus d’informations sur les projets, consultez « À propos des Projects ».

  1. Accédez à votre projet.

  2. En bas d’un tableau, d’un groupe d’éléments ou d’une colonne dans la disposition de tableau, cliquez sur .

    Capture d’écran montrant la ligne inférieure d’une vue de tableau. Le bouton « + » est mis en évidence avec un encadré orange.

  3. Cliquez sur Créer un problème.

  4. En haut de la boîte de dialogue « Créer un problème », sélectionnez le dépôt dans lequel vous souhaitez créer le nouveau problème.

    Capture d’écran montrant la boîte de dialogue « Créer un problème ».

  5. Sous le menu déroulant des dépôts, tapez un titre pour le nouveau problème.

  6. Si vous le souhaitez, utilisez les champs situés sous le champ de titre pour définir les destinataires, les étiquettes et les jalons, et ajoutez le nouveau problème à d’autres projets.

  7. Si vous le souhaitez, tapez une description de votre problème.

  8. Si vous voulez éventuellement créer d’autres problèmes, sélectionnez Créer plus et la boîte de dialogue se rouvrira quand vous créerez votre nouveau problème.

  9. Cliquez sur Créer.

Création d’un problème à partir d’une note de projet (classique)

Si vous utilisez un projet (classique) pour suivre et hiérarchiser votre travail, vous pouvez convertir les notes en problèmes. Pour plus d’informations, consultez « À propos des projects (classic) » et « Ajout de notes à un project (classic) ».

Création d’un problème à partir d’un élément de liste de tâches

Dans un problème, vous pouvez utiliser des listes de tâches pour diviser le travail en tâches plus petites et suivre l’ensemble du travail jusqu’à sa complétion. Si une tâche nécessite une discussion ou un suivi plus approfondi, vous pouvez convertir la tâche en problème en pointant sur la tâche et en cliquant sur dans le coin supérieur droit de la tâche. Pour plus d’informations, consultez « À propos des listes de tâches ».

Création d’un problème à partir d’une requête d’URL

Vous pouvez utiliser des paramètres de requête pour ouvrir des problèmes. Les paramètres de requête sont des éléments facultatifs d’URL que vous pouvez personnaliser pour partager une vue de page web spécifique, comme des résultats de filtre de recherche ou un modèle de problème sur GitHub. Pour créer vos propres paramètres de requête, vous devez faire correspondre la paire clé-valeur.

Astuce : Vous pouvez également créer des modèles de problème qui s’ouvrent avec des étiquettes, des destinataires et un titre de problème par défaut. Pour plus d’informations, consultez « Utilisation de modèles pour encourager les problèmes et demandes de tirage utiles ».

Vous devez disposer des autorisations appropriées pour chaque action dont vous voulez utiliser le paramètre de requête équivalent. Par exemple, vous devez avoir l’autorisation d’ajouter une étiquette à un problème pour utiliser le paramètre de requête labels. Pour plus d’informations, consultez « Rôles de dépôt pour une organisation ».

Si vous créez une URL non valide avec des paramètres de requête, ou si vous n’avez pas les autorisations appropriées, l’URL renvoie une page d’erreur 404 Not Found. Si vous créez une URL qui dépasse la limite du serveur, l’URL retourne une page d’erreur 414 URI Too Long.

Paramètre de requête.Exemple
titlehttps://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report crée un problème avec l’étiquette « bug » et le titre « New bug report ».
bodyhttps://github.com/octo-org/octo-repo/issues/new?title=New+bug+report&body=Describe+the+problem. crée un problème avec le titre « New bug report » et le commentaire « Describe the problem » dans le corps du problème.
labelshttps://github.com/octo-org/octo-repo/issues/new?labels=help+wanted,bug crée un problème avec les étiquettes « help wanted » et « bug ».
milestonehttps://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones crée un problème avec le jalon « testing milestones ».
assigneeshttps://github.com/octo-org/octo-repo/issues/new?assignees=octocat crée un problème et l’affecte à @octocat.
projectshttps://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1 crée un problème avec le titre « Bug fix » et l'ajoute au projet 1 de l'organisation.
templatehttps://github.com/octo-org/octo-repo/issues/new?template=issue_template.md crée un problème avec un modèle dans le corps du problème. Le paramètre de requête template fonctionne avec des modèles stockés dans un sous-répertoire ISSUE_TEMPLATE dans le répertoire racine, docs/ ou .github/ d’un dépôt. Pour plus d’informations, consultez « Utilisation de modèles pour encourager les problèmes et demandes de tirage utiles ».

Vous pouvez également utiliser des paramètres de requête d’URL pour remplir les champs de texte personnalisés que vous avez définis dans les modèles de formulaires de problème. Les paramètres de requête pour les champs de formulaire de problème peuvent également être passés au sélecteur de modèle de problème. Pour plus d’informations, consultez « Syntaxe du schéma de formulaire de GitHub ».

Création d’un problème à partir d’une alerte code scanning

Remarque : Le suivi des alertes d’code scanning dans les problèmes est en version bêta et peut être amené à changer.

Cette fonctionnalité prend en charge l’exécution d’analyses de manière native via GitHub Actions ou de manière externe via l’infrastructure CI/CD existante ainsi que les outils d’code scanning tiers, mais pas à l’aide d’outils de suivi tiers.

Si vous utilisez des problèmes pour suivre et hiérarchiser votre travail, vous pouvez utiliser des problèmes pour suivre les alertes code scanning.

Pour plus d’informations sur la création de problèmes pour suivre les alertes d’code scanning, consultez « Suivi des alertes d’analyse du code dans les problèmes en utilisant des listes de tâches ».

Pour aller plus loin