N-HiTec Logo

Pull Requests sur GitHub

Qu'est-ce qu'une Pull Request ?

Les pull requests (ou PR) sont un mécanisme essentiel de GitHub qui permet aux développeurs de collaborer efficacement sur des projets. C'est la pierre angulaire du travail collaboratif moderne !

Revue de code

Permet de valider la qualité avant l'intégration

Discussion

Facilite les échanges sur les modifications

Collaboration

Plusieurs personnes peuvent contribuer

Traçabilité

Historique complet des changements

Créer une Pull Request

Avant de créer une PR, assurez-vous que votre branche est à jour et poussée sur GitHub :

1

Créer et pousser votre branche

bash
# Créer une branche pour votre fonctionnalité
git checkout -b feature/nouvelle-fonctionnalite

# Faire vos modifications et commiter
git add .
git commit -m "Ajout de la nouvelle fonctionnalité"

# Pousser vers GitHub
git push origin feature/nouvelle-fonctionnalite
2

Ouvrir la PR sur GitHub

  • Aller sur le dépôt GitHub
  • Cliquer sur "Compare & pull request"
  • Remplir le titre et la description
  • Sélectionner les reviewers (si nécessaire)
  • Cliquer sur "Create pull request"

Processus de révision

Une fois la PR créée, elle passe par un processus de révision collaboratif :

Commentaires généraux

Les reviewers peuvent laisser des commentaires sur la PR dans son ensemble pour discuter de l'approche ou des choix techniques.

Commentaires ligne par ligne

Possibilité de commenter des lignes spécifiques de code pour suggérer des améliorations précises.

Approbations

Les reviewers peuvent approuver la PR une fois qu'ils sont satisfaits des modifications.

Demandes de modifications

Si des changements sont nécessaires, les reviewers peuvent bloquer la fusion jusqu'à correction.

Répondre aux commentaires

Après la révision, vous devrez peut-être apporter des modifications :

bash
# Faire les modifications demandées
git add .
git commit -m "Corrections suite à la revue de code"

# Pousser les modifications (la PR se met à jour automatiquement)
git push origin feature/nouvelle-fonctionnalite

Bonnes pratiques

  • Répondez à chaque commentaire, même si c'est juste "✅ Corrigé"
  • Soyez ouvert aux suggestions et aux critiques constructives
  • Marquez les conversations comme résolues une fois traitées
  • Pushez régulièrement pour que les reviewers voient vos progrès

Fusionner la Pull Request

Une fois la PR approuvée, vous pouvez la fusionner. GitHub propose plusieurs méthodes :

1
Merge commit

Crée un commit de merge. Conserve tout l'historique de la branche. Recommandé pour les grosses fonctionnalités.

2
Squash and merge

Combine tous les commits en un seul. Rend l'historique plus propre. Idéal pour les petites PR.

3
Rebase and merge

Réapplique les commits sur la branche principale. Historique linéaire sans commit de merge. Pour les puristes.

Après la fusion :

bash
# Supprimer la branche locale
git branch -d feature/nouvelle-fonctionnalite

# Supprimer la branche distante (GitHub le propose automatiquement)
git push origin --delete feature/nouvelle-fonctionnalite

En résumé

Les PR permettent de proposer des modifications de manière structurée

Elles facilitent la revue de code et la collaboration

Le processus inclut : création, révision, corrections, approbation, fusion

Choisissez la méthode de fusion adaptée à votre projet

N'oubliez pas de supprimer les branches après fusion !

💡 Conseil pro : Faites des PR de petite taille ! Elles sont plus faciles à réviser et ont plus de chances d'être approuvées rapidement. Une bonne PR = une fonctionnalité ou un fix à la fois.