Gestion de projet
Une relecture de code utile tient à trois réglages, pas au talent du relecteur
Ce que la relecture trouve vraiment, combien de lignes faire relire, qui relit et en combien de temps : les trois réglages qui décident de son utilité.
Un correctif est écrit en vingt minutes. Il est relu trois jours plus tard, commenté sur dix points, réécrit, relu encore. Il part la semaine suivante, et casse une fonction voisine que personne n'avait regardée.
Cette histoire est banale. Elle décrit la façon la plus courante dont la relecture de code échoue dans une petite entreprise : non par manque de sérieux, mais par défaut de réglage.
La relecture de code, c'est-à-dire faire lire par un collègue la modification qu'on s'apprête à intégrer au logiciel, est une pratique ancienne et peu coûteuse. Trois réglages décident de son utilité : qui relit, quelle quantité, et dans quel délai. Le talent individuel du relecteur pèse moins lourd qu'on ne le croit.
Ce que la relecture trouve vraiment
L'intuition courante est simple : relire sert à attraper des fautes. Une étude menée chez Microsoft et publiée en 2013 par Alberto Bacchelli et Christian Bird nuance cette idée.
Les auteurs ont observé dix-sept sessions de relecture dans seize équipes, classé le contenu de 570 commentaires, et interrogé 873 développeurs ainsi que 165 responsables.
Trouver des défauts reste la motivation numéro un, citée en premier par 44 % des développeurs comme des responsables.
Le résultat observé est autre. Les commentaires qui signalent un défaut représentent 14 % du total, et n'arrivent qu'en quatrième position sur neuf catégories. La première, avec 29 % des commentaires, porte sur l'amélioration du code : lisibilité, code inutile, respect des conventions de l'équipe. Sur les 78 commentaires de défaut, cinq seulement concernent la sécurité.
Une relecture attrape donc des erreurs, mais elle produit surtout de la cohérence. Elle aligne une équipe sur une manière d'écrire et fait connaître le code à ceux qui devront le modifier plus tard.
La même étude donne le motif profond. La difficulté principale d'un relecteur n'est pas de repérer une faute, c'est de comprendre pourquoi la modification a été faite. Faute de saisir l'intention, il juge la forme.
L'analogie est celle du maître d'œuvre. Un plan sans note d'intention se relit mal : on discute l'épaisseur d'un mur sans savoir à quoi sert la pièce.
Qui relit : la règle du second regard
Première règle, la plus souvent contournée : celui qui a écrit ne relit pas. Ce n'est pas une question de confiance, mais de point de vue. Personne ne voit ses propres oublis, parce que l'intention reste en tête et comble les vides.
L'analogie est celle de la lettre administrative. On relit trois fois son propre courrier sans voir la faute qui saute aux yeux du destinataire.
Deuxième question : combien de relecteurs. La réponse dépend du risque, pas du nombre de personnes disponibles. Chez Google, une étude de 2018 portant sur neuf millions de modifications relues donne un médian d'un seul relecteur. Moins d'un quart des modifications en comptent plus d'une.
Chaque relecteur supplémentaire ajoute du délai, et le troisième avis apporte peu sur une modification courte. Une personne suffit si la zone est connue et qu'un test automatique couvre la fonction.
Deux relecteurs se justifient ailleurs : le code qui touche à l'argent, aux données personnelles ou à l'authentification, où une erreur ne se rattrape pas.
Troisième règle : le relecteur doit avoir le droit de refuser. Un avis consultatif ne protège personne. La documentation de GitHub décrit l'option qui impose l'approbation par une personne autre que celle qui a envoyé la modification, et l'annulation de cette approbation si de nouvelles modifications arrivent ensuite.
Combien de lignes à la fois
Le volume décide de la qualité du regard. Chez Google, la modification relue fait 24 lignes en médiane. Plus de 10 % portent sur une seule ligne, et 90 % touchent moins de dix fichiers.
La recommandation interne va dans le même sens : cent lignes constituent une taille raisonnable, mille lignes sont généralement trop. La dispersion compte autant que le total. Deux cents lignes dans un seul fichier passent ; les mêmes réparties sur cinquante fichiers ne passent pas.
Les éditeurs d'outils publient des repères voisins. SmartBear recommande de ne pas dépasser 400 lignes par session, de rester sous 500 lignes par heure, et de ne pas relire plus de soixante minutes d'affilée. Ces chiffres viennent d'une étude interne chez Cisco, publiée par l'éditeur et non évaluée par des pairs : un ordre de grandeur, pas une loi.
L'analogie est celle du notaire. Vérifier un acte de deux pages prend vingt minutes, et les erreurs se voient. Le même notaire, face à deux cents pages, signe en survolant.
Conséquence pratique : découper le travail n'est pas une manie d'ingénieur. Une modification de mille lignes, découpée en cinq, se relit mieux et part plus tôt.
En combien de temps
Le délai est le réglage le plus négligé, et celui qui coûte le plus cher. Toujours chez Google, la durée médiane d'une relecture complète est inférieure à quatre heures. Le premier retour arrive en moins d'une heure pour une petite modification, et en cinq heures environ pour une très grosse. En semaine, 70 % des modifications sont intégrées moins de vingt-quatre heures après leur envoi.
Ces chiffres ne mesurent pas la vitesse des individus, mais un effet de file. Une modification qui attend bloque les suivantes.
L'analogie est celle de la caisse au supermarché. Un client lent ne coûte pas grand-chose ; une seule caisse ouverte quand dix personnes attendent coûte toute la file.
La règle publiée par Google pour ses équipes tient en une phrase : une journée ouvrée est le délai maximal pour répondre à une demande de relecture, sauf en pleine tâche de fond.
Ce délai a un corollaire désagréable. Une relecture rapide et exigeante passe mieux qu'une relecture lente et sévère. Des retours le jour même font atterrir la modification en une journée. Trois jours plus tard, l'auteur est passé à autre chose, et chaque correction coûte un rappel de contexte.
Ce que l'auteur doit écrire avant de demander
Le point de blocage identifié en 2013 était la compréhension de l'intention. Un relecteur qui doit reconstituer le raisonnement à partir des lignes modifiées devine, et commente ce qu'il voit le mieux : la forme.
Trois phrases suffisent, écrites avant de demander l'avis. Ce que la modification fait, en langage courant. Pourquoi maintenant. Et ce qui mérite le plus d'attention, par exemple une requête lente ou une règle de calcul nouvelle.
Google ajoute une pratique complémentaire dans son guide interne : annoter soi-même la modification pour indiquer par où commencer. L'auteur y gagne aussi, parce qu'expliquer son travail oblige à le relire.
Le dispositif minimal pour une équipe de dix personnes
Voici ce qui tient avec deux développeurs et un prestataire.
Le premier élément est un point de passage unique : aucune modification ne rejoint la version utilisée en production sans relecture, et l'outil refuse l'intégration tant qu'une approbation manque. C'est un réglage, pas une consigne orale.
Le deuxième est un créneau fixe. Deux plages de trente minutes par jour, une le matin et une en fin d'après-midi, pendant lesquelles les demandes en attente passent avant tout le reste. Un délai maximal se tient avec un rendez-vous, pas avec de la bonne volonté.
Le troisième est une grille courte, affichée. Trois questions : la modification fait-elle ce qu'elle annonce ; casse-t-elle un cas déjà couvert par un test ; laisse-t-elle une trace compréhensible pour celui qui reprendra ce code dans six mois. Le reste, indentation, nom des variables, découpage en fonctions, se règle mieux avec un formateur automatique qu'avec un humain.
La relecture ne remplace pas les tests automatiques, et les commentaires de sécurité y sont rares : cinq sur 570 dans l'étude de 2013.
Enfin, mesurer deux choses pendant un mois : le délai médian avant la première réponse, et le nombre de modifications relues. Au-delà d'une journée, le problème est un manque de créneau, pas de compétence.
Ce qu'il faut retenir
- Une relecture sert moins à attraper des fautes qu'à aligner une équipe : dans l'étude Microsoft de 2013, 14 % des commentaires signalent un défaut, 29 % portent sur la lisibilité et les conventions.
- Celui qui a écrit ne relit pas son propre travail. Un seul autre relecteur suffit pour une modification courte ; deux se justifient sur l'argent, les données personnelles et l'authentification.
- La taille commande la qualité : chez Google, la modification relue fait 24 lignes en médiane. Cent lignes est une bonne cible, mille lignes est trop.
- Le délai compte autant que le contenu : moins de quatre heures en médiane chez Google, une journée ouvrée au maximum comme règle interne.
- Un auteur qui explique en trois phrases ce qu'il change, pourquoi et où regarder obtient des retours utiles au lieu de remarques de forme.
- Une relecture ne remplace ni les tests automatiques ni un contrôle de sécurité dédié.
À lire : La dette technique ne figure pas au bilan, elle apparaît dans vos délais et Pourquoi l'agile rate en PME : le rôle du chef de produit.
Un besoin de méthode ? Voir nos formations.
Pour aller plus loin · Situer votre entreprise en 30 minutes
Références
- [1] Caitlin Sadowski, Emma Söderberg, Luke Church, Michal Sipko et Alberto Bacchelli, « Modern Code Review: A Case Study at Google », ICSE-SEIP 2018, Göteborg — étude fondée sur douze entretiens, une enquête auprès de 44 répondants et l'analyse des journaux de relecture de neuf millions de modifications ; la taille médiane d'une modification relue est de 24 lignes, plus de 10 % des modifications portent sur une seule ligne, 90 % touchent moins de dix fichiers, et le nombre médian de relecteurs est de un, moins d'un quart des modifications en comptant plus d'un ; la durée médiane d'une relecture complète est inférieure à quatre heures, le premier retour arrive en moins d'une heure pour les petites modifications et en environ cinq heures pour les très grosses ; en semaine, 70 % des modifications sont intégrées moins de 24 heures après leur envoi ; consulté le 19 novembre 2026
- [2] Alberto Bacchelli et Christian Bird, « Expectations, Outcomes, and Challenges of Modern Code Review », ICSE 2013, San Francisco — dix-sept observations dans seize équipes chez Microsoft, classification de 570 commentaires de relecture, enquête auprès de 873 développeurs et 165 responsables ; trouver des défauts est la motivation première pour 44 % des développeurs et 44 % des responsables, mais les commentaires de défaut ne représentent que 78 des 570 commentaires classés, soit 14 %, et arrivent en quatrième position sur neuf catégories, derrière les améliorations de code (165 commentaires, 29 %) ; parmi ces 78 commentaires, 65 portent sur la logique, 6 sur un problème de conception, 5 sur la sécurité et 3 sur la gestion des erreurs ; la principale difficulté citée par les relecteurs est de comprendre la raison de la modification ; consulté le 19 novembre 2026
- [3] Google, « The Standard of Code Review » et « Speed of Code Reviews », guide interne de relecture de code publié par Google (eng-practices) — la norme retenue est d'approuver une modification dès qu'elle améliore nettement la santé globale du code, sans exiger la perfection ; le délai de réponse à une demande de relecture ne doit pas dépasser une journée ouvrée, sauf si le relecteur est engagé dans une tâche de fond ; la lenteur des relectures ralentit l'équipe entière et pousse à intégrer du code de moindre qualité ; consulté le 19 novembre 2026
- [4] Google, « Small CLs », guide eng-practices — une modification doit traiter un seul sujet et rester autonome ; cent lignes constituent une taille raisonnable, mille lignes sont généralement trop volumineuses ; la dispersion compte autant que le nombre de lignes, une modification de deux cents lignes réparties sur cinquante fichiers étant généralement trop large ; les petites modifications sont relues plus vite, plus attentivement, et introduisent moins de défauts ; consulté le 19 novembre 2026
- [5] SmartBear, « Best Practices for Code Review » — l'éditeur recommande de ne pas relire plus de 200 à 400 lignes à la fois, de rester sous 500 lignes par heure et de ne pas dépasser soixante minutes de relecture d'affilée, en s'appuyant sur une étude menée auprès d'une équipe de programmation de Cisco Systems ; ces repères proviennent d'une publication d'éditeur et non d'une étude évaluée par des pairs ; consulté le 19 novembre 2026
- [6] GitHub, « About protected branches », documentation — il est possible d'exiger un nombre donné d'approbations avant qu'une demande de fusion puisse rejoindre une branche protégée, d'exiger l'approbation d'un propriétaire de code, et d'imposer que la dernière modification envoyée soit approuvée par une personne autre que celle qui l'a envoyée ; les approbations peuvent être annulées automatiquement lorsque de nouvelles modifications sont ajoutées après la relecture ; consulté le 19 novembre 2026