Skip to main content

Enterprise Server 3.20 est actuellement disponible en tant que version candidate.

Création d’un modèle de pull request pour votre dépôt

Quand vous ajoutez un modèle de demande de tirage (pull request) à votre dépôt, les contributeurs du projet voient automatiquement le contenu de ce modèle dans le corps de la demande de tirage.

Dans cet article

Pour plus d’informations, consultez « À propos des modèles de problème et de demande de tirage ».

Vous pouvez créer un sous-répertoire PULL_REQUEST_TEMPLATE/ dans l’un des dossiers pris en charge pour y stocker plusieurs modèles de demande de tirage (pull request), puis utiliser le paramètre de requête template pour spécifier le modèle qui va remplir le corps de la demande de tirage. Pour plus d’informations, consultez « Utilisation des paramètres de requête pour créer une pull request ».

Vous pouvez créer des modèles de pull request par défaut pour votre organisation ou votre compte personnel. Pour plus d’informations, consultez « Création d’un fichier d’intégrité de la communauté par défaut ».

Ajout d’un modèle de pull request

  1. Au-dessus de la liste des fichiers, sélectionnez le menu déroulant Ajouter un fichier , puis cliquez sur Créer un nouveau fichier.

Vous pouvez également cliquer sur dans l’arborescence de fichiers à gauche.

Capture d’écran de la page principale d’un référentiel mettant en évidence l’icône « Ajouter un fichier » et l’icône « signe plus », décrites ci-dessus, avec un contour orange.

  1. Dans le champ du nom de fichier :

    • Pour rendre votre modèle de demande de tirage visible dans le répertoire racine du dépôt, nommez le modèle de demande de tirage pull_request_template.md.
    • Pour rendre votre modèle de demande de tirage visible dans le répertoire docs du dépôt, nommez le modèle de demande de tirage docs/pull_request_template.md.
    • Pour stocker votre fichier dans un répertoire masqué, nommez le modèle de pull request .github/pull_request_template.md.
    • Pour créer plusieurs modèles de demande de tirage et utiliser le paramètre de requête template afin de spécifier un modèle permettant de remplir le corps de la demande de tirage, tapez .github/PULL_REQUEST_TEMPLATE/ , puis le nom de votre modèle de demande de tirage. Par exemple : .github/PULL_REQUEST_TEMPLATE/pull_request_template.md. Vous pouvez également stocker plusieurs modèles de pull request dans un sous-répertoire PULL_REQUEST_TEMPLATE du répertoire racine ou des répertoires docs/. Pour plus d’informations, consultez « Utilisation des paramètres de requête pour créer une pull request ».
  2. Dans le corps du nouveau fichier, ajoutez votre modèle de demande de tirage. Ce modèle peut consister à demander à inclure : * Référence à un problème connexe dans votre dépôt.

    • Description des modifications proposées dans le pull request.
    •           [              @mentions              ](/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#mentioning-people-and-teams) de la personne ou de l’équipe responsable de passer en revue les changements proposés.
      
  3. Cliquez sur Commiter les changements.

  4. Dans le champ de message de validation, tapez un message de validation court et descriptif qui indique la modification que vous avez apportée au fichier. Vous pouvez attribuer la validation à plusieurs auteurs dans le message de validation. Pour plus d’informations, consultez « Création d'un commit avec plusieurs auteurs ».

  5. Sous les champs de message de commit, choisissez si vous souhaitez ajouter votre commit à la branche actuelle ou à une nouvelle branche. Si votre branche actuelle est la branche par défaut, vous devez choisir de créer une branche pour votre validation, puis de créer une demande de tirage (pull request). Pour plus d’informations, consultez « Création d’une pull request ».

    Capture d’écran d’une demande de tirage GitHub montrant une case d’option permettant de commiter directement dans la branche main ou de créer une branche. Une nouvelle branche est sélectionnée.
    Les modèles sont accessibles aux collaborateurs quand ils sont fusionnés avec la branche par défaut du dépôt.

  6. Cliquez sur Valider les modifications ou Proposer des modifications.

Pour aller plus loin

  •         [AUTOTITLE](/communities/using-templates-to-encourage-useful-issues-and-pull-requests/about-issue-and-pull-request-templates)
    
  •         [AUTOTITLE](/issues/tracking-your-work-with-issues/creating-an-issue)
    
  •         [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)