Comment ouvrir une pull request

Quand utiliser ce guide

Utilise ce guide quand tu veux :

  • Proposer des modifications de code pour review avant fusion
  • Lier une PR à une issue pour la fermer automatiquement à la fusion
  • Assigner des reviewers à une PR
  • Vérifier que la CI est verte avant de fusionner

Pré-requis

  • Un dépôt avec au moins deux branches (ta branche de travail + main ou autre branche cible)
  • Le niveau d'accès Developer minimum sur le dépôt

Étapes

1. Pousser ta branche de travail

Avant d'ouvrir une PR, ta branche doit être poussée sur gitrust :

git push origin ma-branche

Sortie attendue : 

To git@gitrust.example.com:owner/repo.git
 * [new branch]      ma-branche -> ma-branche

2. Ouvrir le formulaire de nouvelle PR

Navigue vers /{owner}/{repo}/pulls/new.

gitrust peut aussi afficher une bannière de suggestion au sommet de la page du dépôt juste après un push récent : « Ouvrir une pull request pour ma-branche ». Clique dessus si elle apparaît.

Formulaire de création d'une pull request

3. Remplir le formulaire

Champ Valeur recommandée
Titre Phrase courte à l'impératif : Ajoute la validation email, Corrige le bug #42
Branche source Ta branche de travail (ma-branche)
Branche cible main (ou la branche de destination souhaitée)
Description Contexte, lien vers l'issue (Closes #N), captures d'écran si pertinent
Reviewers Pseudo(s) des coéquipiers à notifier
Labels Optionnel — pour catégoriser (voir Utiliser les labels)

Mot-clé Closes #N : si tu écris Closes #3 dans la description ou dans un message de commit sur cette branche, gitrust fermera automatiquement l'issue #3 lors de la fusion.

Clique Ouvrir la pull request.

4. Vérifier les onglets de la PR

Une fois créée, la PR s'affiche sur /{owner}/{repo}/pulls/{num} avec plusieurs onglets :

  • Conversation : fil de discussion, commentaires généraux
  • Commits : liste des commits inclus dans la PR
  • Fichiers modifiés : diff complet, ligne par ligne — c'est ici que les reviewers commentent
  • CI : statut du pipeline CI (si configuré)

Onglets d'une pull request ouverte

5. Suivre le statut CI

Si le dépôt a une configuration CI (.gitrust-ci.yml), gitrust exécute automatiquement le pipeline sur la branche de la PR. Le statut apparaît en bas de la PR :

  • En attente / En cours : le pipeline tourne
  • Réussi (vert) : tous les checks passent
  • Échoué (rouge) : au moins un check a échoué — clique sur « Voir les détails » pour lire les logs

6. Répondre à une review

Quand un reviewer laisse des commentaires :

  1. Pousse de nouveaux commits sur la même branche pour adresser les remarques
  2. Réponds aux commentaires dans l'interface pour indiquer ce qui a été fait
  3. Le reviewer peut alors approuver la PR

Variantes

PR en mode brouillon

Si ton code n'est pas encore prêt pour review, ouvre la PR en cochant Brouillon lors de la création. Une PR en brouillon ne peut pas être fusionnée. Elle est visible par l'équipe pour discussion préalable. Passe-la en « Prête pour review » quand tu es prêt.

Mettre à jour la branche avant fusion

Si des commits ont été ajoutés sur main depuis que tu as créé ta branche, rebaser avant de fusionner :

git fetch origin
git rebase origin/main
git push origin ma-branche --force-with-lease

Voir aussi