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 demande de tirage à partir d’une duplication » et « À propos des duplications (fork) ».
Vous pouvez spécifier la branche dans laquelle vous voulez fusionner vos changements quand vous créez votre demande de tirage. 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 quelqu’un fusionne la demande de tirage. Pour plus d’informations, consultez « Relier une demande de tirage à un problème ».
Changement de la plage de branches et du dépôt de destination
Par défaut, les demandes de tirage 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 doivent ici correspondre à des noms de branche inclus dans votre dépôt 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 demande de tirage. Toute personne en mesure de pousser (push) vers le dépôt de base reçoit une notification par e-mail et voit la nouvelle demande de tirage dans son tableau de bord lors de sa prochaine connexion.
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.
Tip
- À 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 chargés de maintenance du projet peuvent ajouter un modèle de demande de tirage pour un dépôt. Les modèles incluent des invites d’insertion d’informations dans le corps d’une demande de tirage. Pour plus d’informations, consultez « À propos des modèles de problème et de demande de tirage ».
Création de la demande de tirage
Note
Pour plus d’informations sur GitHub CLI, consultez À propos de GitHub CLI.
Pour créer une demande de tirage, utilisez la sous-commande gh pr create
.
gh pr create
Pour affecter une demande de tirage à 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 que la demande de tirage soit fusionnée, utilisez les indicateurs --base
ou -B
. Pour spécifier la branche qui contient les commits de votre demande de tirage, utilisez les indicateurs --head
ou -H
.
gh pr create --base my-base-branch --head my-changed-branch
Pour inclure un titre et un corps dans la nouvelle demande de tirage, utilisez les indicateurs --title
et --body
.
gh pr create --title "The bug is fixed" --body "Everything works again"
Pour marquer une demande de tirage en tant que brouillon, utilisez l’indicateur --draft
.
gh pr create --draft
Pour ajouter des étiquettes ou des jalons à la nouvelle demande de tirage, utilisez les indicateurs --label
et --milestone
.
gh pr create --label "bug,help wanted" --milestone octocat-milestone
Pour ajouter la nouvelle demande de tirage à 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 demande de tirage dans votre navigateur web par défaut, utilisez l’indicateur --web
.
gh pr create --web
Modifier les fichiers de votre demande de tirage
Après avoir ouvert votre demande de tirage, vous pouvez continuer à apporter des modifications aux fichiers en ajoutant de nouveaux commits à votre branche principale.
Pour aller plus loin
- Création d’une demande de tirage à partir d’une duplication
- Maintien de la synchronisation de votre demande de tirage avec la branche de base
- Changement de la branche de base d’une demande de tirage
- Ajout de problèmes et de demandes de tirage à un project (classic)
- Création d’un problème
- Affectation de problèmes et demandes de tirage à d’autres utilisateurs GitHub
- Écriture sur GitHub