Formations — 1 037 leçons en français

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 :

  1. Quel problème ce changement résout-il ? Si la description ne le dit pas, la revue s'arrête là.
  2. Le code fait-il ça ? Pas « est-il correct » dans l'absolu : fait-il ce que l'intention annonce.
  3. Qu'est-ce qui pourrait mal tourner ? Erreurs ignorées, cas limites, données nulles, concurrence, sécurité.
  4. 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.

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.