Accueil › Git & CI/CD › Ce qu'une revue cherche vraiment
Ce qu'une revue cherche vraiment
La revue de codeintermediaire
Une revue de code n'est pas une correction de copie. C'est une décision d'intégration prise par quelqu'un qui n'a pas écrit le changement.
Elle répond à quatre questions, dans cet ordre :
- Quel problème ce changement résout-il ? Si la description ne le dit pas, la revue s'arrête là.
- Le code fait-il ça ? Pas « est-il correct » dans l'absolu : fait-il ce que l'intention annonce.
- Qu'est-ce qui pourrait mal tourner ? Erreurs ignorées, cas limites, données nulles, concurrence, sécurité.
- Le prochain lecteur comprendra-t-il ? Dans six mois, sans l'auteur.
- const utilisateur = await trouverUtilisateur(id);
- return utilisateur.email;
+ const utilisateur = await trouverUtilisateur(id);
+ if (!utilisateur) return null;
+ return utilisateur.email;
Le relecteur utile ne dit pas « ajoutez un test ». Il dit ce qui casse :
« trouverUtilisateur renvoie null quand le compte est supprimé, et cette
route est appelée après une suppression ».
Ce qu'une revue ne cherche pas
L'indentation, l'ordre des imports, les guillemets, la présence d'un point-virgule. Tout cela se règle par un formateur automatique. Chaque minute de revue passée dessus est une minute non passée sur ce qu'aucun outil ne voit.
Et la revue ne cherche pas non plus à prouver que le relecteur aurait fait autrement. « Ce n'est pas comme ça que je l'aurais écrit » n'est pas un défaut.
Les termes à connaître
- Revue de code
Lecture d'un changement par quelqu'un d'autre que son auteur, avant intégration. Son produit n'est pas une note : c'est une décision — on intègre, ou on demande une modification.
- Intention du changement
Le problème que le changement prétend résoudre. Un relecteur qui ne l'a pas comprise ne peut rien valider d'autre que la syntaxe.
- Approbation
Déclaration formelle qu'un relecteur accepte que le changement soit intégré. Sur la plupart des forges, elle devient caduque si l'auteur pousse de nouveaux commits — selon la configuration de la branche.
- Demande de changement
Verdict bloquant d'un relecteur. À réserver à ce qui empêche réellement l'intégration ; l'utiliser pour une préférence de style bloque le travail de quelqu'un d'autre pour rien.
- Propriétaire de code
Personne ou équipe dont l'approbation est exigée pour toucher certains chemins du dépôt. Déclaré dans un fichier de la forge, appliqué automatiquement à l'ouverture de la pull request.
- Nitpick
Commentaire de détail sans conséquence sur le comportement. Il a sa place s'il est annoncé comme tel ; il n'a jamais sa place dans une demande de changement.
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.