Creating an issue

Issues can be created in a variety of ways, so you can choose the most convenient method for your workflow.

Qui peut utiliser cette fonctionnalité ?

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

Dans cet article

Issues can be used to keep track of bugs, enhancements, or other requests. For more information, see "À 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 ».

Creating an issue from a repository

  1. Dans votre instance GitHub Enterprise Server, 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. If your repository uses issue templates, next to the type of issue you'd like to open, click Get started.

    If the type of issue you'd like to open isn't included in the available options, click Open a blank issue.

    Screenshot of the template chooser for an issue. Below the template choices, a link, labeled "Open a blank issue," is outlined in dark orange.

  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.

Creating an issue with 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. To learn more about GitHub CLI, see "À propos de GitHub CLI."

To create an issue, use the gh issue create subcommand. To skip the interactive prompts, include the --body and the --title flags.

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

You can also specify assignees, labels, milestones, and projects.

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

Creating an issue from a comment

You can open a new issue from a comment in an issue or pull request. When you open an issue from a comment, the issue contains a snippet showing where the comment was originally posted.

  1. Navigate to the comment that you would like to open an issue from.

  2. In that comment, click .

    Screenshot of a comment on a pull request. The kebab button is outlined in dark orange.

  3. Click Reference in new issue.

  4. Use the "Repository" dropdown menu, and select the repository you want to open the issue in.

  5. Type a descriptive title and body for the issue.

  6. Click Create issue.

  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.

Creating an issue from code

You can open a new issue from a specific line or lines of code in a file or pull request. When you open an issue from code, the issue contains a snippet showing the line or range of code you chose. You can only open an issue in the same repository where the code is stored.

  1. Dans votre instance GitHub Enterprise Server, accédez à la page principale du dépôt.

  2. Locate the code you want to reference in an issue:

    • To open an issue about code in a file, navigate to the file.
    • To open an issue about code in a pull request, navigate to the pull request and click Files changed. Then, browse to the file that contains the code you want included in your comment, and click View.

  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. To the left of the code range, click . In the dropdown menu, click Reference in new issue.

    Screenshot of a file, with 8 lines selected. To the left of the first selected line, a button labeled with a kebab icon is outlined in dark orange.

  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.

Creating an issue from discussion

People with triage permission to a repository can create an issue from a discussion.

When you create an issue from a discussion, the contents of the discussion post will be automatically included in the issue body, and any labels will be retained. Creating an issue from a discussion does not convert the discussion to an issue or delete the existing discussion. For more information about GitHub Discussions, see "À 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. In the right sidebar, click Create issue from discussion.

    Screenshot of the sidebar in a discussion. The "Create issue from discussion" option is outlined in dark orange.

  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.

Creating an issue from a project

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 ». For more information about Projects, see "À propos des Projects."

  1. Navigate to your project.

  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.

Creating an issue from a projet (classique) note

If you're using a projet (classique) to track and prioritize your work, you can convert notes to issues. For more information, see "À propos des projects (classic)" and "Ajout de notes à un project (classic)."

Creating an issue from a URL query

You can use query parameters to open issues. Query parameters are optional parts of a URL you can customize to share a specific web page view, such as search filter results or an issue template on GitHub. To create your own query parameters, you must match the key and value pair.

Tip: You can also create issue templates that open with default labels, assignees, and an issue title. For more information, see "Utilisation de modèles pour encourager les problèmes et demandes de tirage utiles."

You must have the proper permissions for any action to use the equivalent query parameter. For example, you must have permission to add a label to an issue to use the labels query parameter. For more information, see "Rôles de dépôt pour une organisation."

If you create an invalid URL using query parameters, or if you don’t have the proper permissions, the URL will return a 404 Not Found error page. If you create a URL that exceeds the server limit, the URL will return a 414 URI Too Long error page.

Query parameterExample
titlehttps://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report creates an issue with the label "bug" and title "New bug report."
bodyhttps://github.com/octo-org/octo-repo/issues/new?title=New+bug+report&body=Describe+the+problem. creates an issue with the title "New bug report" and the comment "Describe the problem" in the issue body.
labelshttps://github.com/octo-org/octo-repo/issues/new?labels=help+wanted,bug creates an issue with the labels "help wanted" and "bug".
milestonehttps://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones creates an issue with the milestone "testing milestones."
assigneeshttps://github.com/octo-org/octo-repo/issues/new?assignees=octocat creates an issue and assigns it to @octocat.
projectshttps://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1 creates an issue with the title "Bug fix" and adds it to the organization's project 1.
templatehttps://github.com/octo-org/octo-repo/issues/new?template=issue_template.md creates an issue with a template in the issue body. The template query parameter works with templates stored in an ISSUE_TEMPLATE subdirectory within the root, docs/ or .github/ directory in a repository. For more information, see "Utilisation de modèles pour encourager les problèmes et demandes de tirage utiles."

Further reading