Accueil › Git & CI/CD › La taille d'une pull request
La taille d'une pull request
La revue de codeintermediaire
La taille d'une pull request est la variable qui décide de la qualité de sa revue. Pas l'ancienneté du relecteur, pas le nombre de relecteurs.
Un relecteur lit attentivement tant qu'il tient le contexte en tête. Passé ce point, il continue à commenter — mais sur ce qui se repère sans effort : les noms, les formulations, l'ordre des arguments. Le symptôme reconnaissable est une énorme pull request approuvée avec deux remarques de style.
Ce qui coûte vraiment
Pas le nombre de lignes du diff : le nombre de choses à comprendre.
PR A : 1 200 lignes — renommage automatique d'un symbole
PR B : 90 lignes — une migration de base + un correctif + un refactor
La première est une revue de cinq minutes. La seconde est trois revues imbriquées, et chacune rend les deux autres plus difficiles à juger.
Les trois découpages qui marchent
# 1. Séparer le mécanique du logique
git commit -m "refactor: renomme Panier en Commande" # une PR
git commit -m "feat: applique la remise fidélité" # une autre
# 2. Empiler : chaque PR cible la précédente
git switch -c etape-2 etape-1
# 3. Intégrer tôt, activer plus tard (drapeau de fonctionnalité)
if (drapeaux.remiseFidelite) appliquerRemise(commande);
Une pull request mélangeant un reformatage global et une correction de bug oblige le relecteur à chercher les deux lignes utiles dans huit cents. Il ne les cherchera pas.
Les termes à connaître
- Coût de revue
L'effort réel demandé au relecteur. Il dépend du nombre de lignes à comprendre et du nombre de sujets différents, pas du nombre de fichiers touchés.
- Fichier généré
Fichier produit par un outil — fichier de verrouillage de dépendances, code compilé, instantané de test. Il gonfle le diff sans rien demander au relecteur, et se marque comme tel pour que la forge le replie.
- Changement mécanique
Renommage, reformatage, déplacement de fichiers. Sans valeur de revue, mais noyant tout le reste s'il est mélangé à un changement de comportement.
- Pull request empilée
Série de pull requests dont chacune cible la précédente au lieu de la branche principale. Chacune reste petite, l'ensemble reste cohérent.
- Drapeau de fonctionnalité
Interrupteur qui active ou non un code déjà intégré. Il permet de livrer une fonctionnalité en plusieurs petits changements sans qu'aucun ne soit visible avant le dernier.
- Branche longue
Branche vivant plusieurs semaines. Elle produit mécaniquement une pull request énorme, et un conflit d'autant plus coûteux que l'attente a été longue.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.