Pull Requests

Une Pull Request (PR) est une demande de fusion : elle sert à proposer que le contenu d’une branche soit intégré dans main. C’est une étape de validation, même si l’on travaille seul.

À quoi ça sert

#

• garder une trace claire de ce qui change et pourquoi,
• permettre une relecture (par soi-même ou un pair),
• déclencher éventuellement une intégration continue (lint, tests),
• garder l’historique de fusion propre (grâce au merge squash).

En pratique, une PR agit comme un mini journal de bord : on y explique le pourquoi et le comment d’un changement avant qu’il soit fusionné.

Quand l’ouvrir

#

Dès qu’une branche est prête à être intégrée dans main :

git push -u origin feat/ma-branche

Une fois la branche poussée, la plateforme (GitHub, GitLab, etc.) propose automatiquement d’ouvrir une PR.

Que mettre dedans

#

Une PR n’a pas besoin d’être longue. Quelques éléments suffisent :

• Titre clair (reprend souvent le message du commit principal).
• Description courte :
  • ce qui a été ajouté ou modifié,
  • pourquoi ce changement était nécessaire,
  • points à tester ou à valider.

Exemple minimal :

feat(dbt): build silver salaries

Ajout des modèles dbt pour les agrégations salaires (silver).
Testé localement avec DuckDB.

Fusionner proprement

#

Une fois la PR relue (ou simplement relue par soi-même), la fusion peut se faire via un merge squash : tous les commits de la branche sont regroupés en un seul avant d’être ajoutés à main.

Cela garde un historique simple :

un commit = une fonctionnalité.

Après la fusion, la branche peut être supprimée — la plupart des plateformes le font automatiquement.