Formations — 1 037 leçons en français

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.

Lire l'explication détaillée et faire le quiz →

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.