Si vous voulez créer une branche pour votre demande de tirage et que vous n’avez pas d’autorisations d’accès en écriture au dépôt, vous pouvez commencer par dupliquer (fork) le dépôt. Pour plus d’informations, consultez « Création d’une pull request à partir d’un fork » et « À propos des forks ».
Vous pouvez spécifier la branche dans laquelle vous voulez fusionner vos changements lorsque vous créez votre pull request. Vous pouvez ouvrir des demandes de tirage uniquement entre deux branches différentes.
Vous pouvez lier une demande de tirage à un problème pour montrer qu’un correctif est en cours et fermer automatiquement le problème lorsque la demande de tirage est fusionnée. Pour plus d’informations, consultez « Relier une demande de tirage à un problème ».
Modification de la plage de branches et du référentiel de destination
Par défaut, les pull requests se basent sur la branche par défaut du dépôt parent. Pour plus d’informations, consultez « À propos des branches ».
Si le dépôt parent par défaut n’est pas correct, vous pouvez changer à la fois le dépôt parent et la branche à l’aide des listes déroulantes. Vous pouvez aussi permuter vos branches principale et de base à l’aide des listes déroulantes pour établir des différences entre les points de référence. Les références ici doivent être des noms de branche dans votre référentiel GitHub.
En ce qui concerne les branches, n’oubliez pas que la branche de base correspond à l’emplacement auquel les changements doivent être appliqués (où) et que la branche principale contient ce que vous aimeriez appliquer (quoi).
Quand vous modifiez le dépôt de base, vous modifiez également les notifications de la pull request. Toute personne ayant la capacité de faire un push vers le dépôt de base recevra une notification par e-mail et verra la nouvelle pull request dans son tableau de bord la prochaine fois qu'elle se connectera.
Quand vous modifiez l’une des informations dans la plage de branches, les zones d’aperçu Commit et Fichiers modifiés sont mises à jour pour présenter votre nouvelle plage.
Conseil
- À l’aide de la vue comparative, vous pouvez configurer des comparaisons sur la période de votre choix. Pour plus d’informations, consultez « Comparaison des validations ».
- Les mainteneurs du projet peuvent ajouter un modèle de proposition de modification pour un répertoire. Les modèles incluent des prompts d'information dans le corps d'une pull request. Pour plus d’informations, consultez « À propos des modèles de problème et de demande de tirage ».
Création de la demande de tirage
-
Sur GitHub, accédez à la page principale du référentiel.
-
Dans le menu « Branches », choisissez la branche qui contient vos commits.
-
Au-dessus de la liste des fichiers, dans la bannière jaune, cliquez sur Comparer et créer une demande de tirage afin de créer une demande de tirage pour la branche associée.
-
Utilisez le menu déroulant de la branche de base pour sélectionner la branche dans laquelle fusionner vos changements, puis utilisez le menu déroulant comparer : pour choisir la branche de rubrique dans laquelle vous avez apporté vos changements.
-
Entrez un titre et une description pour votre demande de tirage.
-
Pour créer une demande de tirage (pull request) prête à être examinée, cliquez sur Créer une demande de tirage. Pour créer un brouillon de demande de tirage, utilisez la liste déroulante et sélectionnez Créer un brouillon de demande de tirage, puis cliquez sur Brouillon de demande de tirage. Si vous êtes membre d’une organisation, vous devrez peut-être demander l’accès au brouillon des demandes de tirage à partir d’un propriétaire d’organisation. Consultez À propos des demandes de tirage (pull requests).
Conseil
Après avoir créé une demande de tirage, vous pouvez demander à une personne spécifique de regarder les changements que vous proposez. Pour plus d’informations, consultez « Demande d’examen de requête pull ».
Une fois votre pull request révisée, elle peut être fusionnée dans le dépôt.
Remarque
Pour plus d’informations sur GitHub CLI, consultez À propos de l’interface CLI GitHub.
Pour créer une pull request, utilisez la sous-commande gh pr create.
gh pr create
Pour attribuer une pull request à une personne, utilisez les indicateurs --assignee ou -a. Vous pouvez utiliser @me pour vous affecter la demande de tirage.
gh pr create --assignee "@octocat"
Pour spécifier la branche dans laquelle vous voulez intégrer la pull request, utilisez les indicateurs --base ou -B. Pour spécifier la branche qui contient les commits de votre pull request, utilisez les options --head ou -H.
gh pr create --base my-base-branch --head my-changed-branch
Pour inclure un titre et un corps dans la nouvelle pull request, utilisez les indicateurs --title et --body.
gh pr create --title "The bug is fixed" --body "Everything works again"
Pour marquer une pull request en tant que brouillon, utilisez le drapeau --draft.
gh pr create --draft
Pour ajouter des labels ou des jalons à la nouvelle pull request, utilisez les drapeaux --label et --milestone.
gh pr create --label "bug,help wanted" --milestone octocat-milestone
Pour ajouter la nouvelle pull request à un projet spécifique, utilisez l’indicateur --project.
gh pr create --project octocat-project
Pour désigner une personne ou une équipe en tant que réviseurs, utilisez l’indicateur --reviewer.
gh pr create --reviewer monalisa,hubot --reviewer myorg/team-name
Pour créer la pull request dans votre navigateur web par défaut, utilisez l’indicateur --web.
gh pr create --web
-
Cliquez sur Prévisualiser Pull Request. GitHub Desktop ouvre une boîte de dialogue de prévisualisation montrant les différences des modifications entre votre branche actuelle et la branche de base.
Sinon, pour accéder directement à GitHub pour créer votre demande de tirage, sélectionnez l’icône de liste déroulante et cliquez sur Créer une demande de tirage.
-
Vérifiez que la branche dans le menu déroulant base : correspond à la branche dans laquelle vous souhaitez fusionner vos changements.
GitHub Desktop vous indique si la branche actuelle peut être fusionnée automatiquement dans la branche de base.
-
Cliquez sur Créer une pull request. GitHub Desktop ouvre votre navigateur par défaut pour vous permettre d’accéder à GitHub.
-
Entrez un titre et une description pour votre demande de tirage.
-
Pour créer une demande de tirage (pull request) prête à être examinée, cliquez sur Créer une demande de tirage. Pour créer un brouillon de demande de tirage, utilisez la liste déroulante et sélectionnez Créer un brouillon de demande de tirage, puis cliquez sur Brouillon de demande de tirage. Si vous êtes membre d’une organisation, vous devrez peut-être demander l’accès au brouillon des demandes de tirage à partir d’un propriétaire d’organisation. Consultez À propos des demandes de tirage (pull requests).
Modification des fichiers dans votre pull request
Après avoir ouvert votre pull request, vous pouvez continuer à apporter des modifications aux fichiers en ajoutant de nouveaux commits à votre branche principale.
Vous pouvez également modifier les fichiers sur le site GitHub.
-
Dans GitHub, accédez à une pull request dans un dépôt.
-
Sur la requête de tirage, cliquez sur Fichiers modifiés.
-
Faites défiler vers le bas jusqu'au fichier que vous souhaitez modifier.
- Si le pull request contient beaucoup de fichiers, vous pouvez utiliser le filtre pour retrouver le fichier. Consultez « Filtrage des fichiers dans une demande de tirage ».
-
Au-dessus du fichier que vous souhaitez modifier, cliquez sur .
- Dans le menu, cliquez sur Modifier fichier.
- Effectuez vos modifications dans l'éditeur et, au moment de valider vos modifications, choisissez de les valider directement sur votre branche principale.