Accueil › Architecture & design patterns › La revue et ce qu'on automatise à sa place
La revue et ce qu'on automatise à sa place
Qualité, tests et detteavance
La revue de code sert à juger ce qu'une machine ne sait pas juger : la règle métier, le nom qui ment, le cas limite oublié, la décision de conception. Tout le reste doit être automatisé avant d'arriver devant un humain.
Classez chaque remarque possible en trois colonnes :
| Remarque | Qui tranche |
|---|---|
| Indentation, guillemets, point-virgule | le formateur |
| Variable inutilisée, promesse non attendue | l'analyse statique |
| Ce nom ne dit pas ce que fait la fonction | le relecteur |
| Cette règle de remise est fausse | le relecteur |
// Ce que l'outil voit sans exécuter le code.
function total(lignes) {
let somme = 0;
const taux = 0.2; // déclarée, jamais utilisée → l'outil le dit
for (const l of lignes) somme += l.prix;
return somme;
}
// Ce que seul un humain voit.
function total(lignes) {
return lignes.reduce((s, l) => s + l.prix, 0); // et la quantité ?
}
La seconde fonction est propre, formatée, sans avertissement, et fausse. Aucun outil ne connaît votre domaine.
Une revue utile tient en trois conditions : elle porte sur un changement petit, elle arrive vite, et elle répond à une question explicite. « Relis ça » n'est pas une question. « Est-ce que ce découpage tient si on ajoute un second mode de paiement ? » en est une.
Les termes à connaître
- Revue de code
La lecture d'un changement par quelqu'un d'autre que son auteur, avant intégration. Son produit n'est pas une liste de corrections mais une décision partagée.
- Analyse statique
L'examen du code sans l'exécuter, par un outil qui applique des règles. Elle attrape ce qui se décide à la lecture seule : variable inutilisée, promesse non attendue, branche inatteignable.
- Formateur
Un outil qui réécrit la mise en forme du code selon une règle unique. Il supprime la catégorie entière des remarques de style en revue.
- Portillon de qualité
Un ensemble de conditions qu'un changement doit remplir pour être intégré. Il remplace le jugement répété par une règle écrite une fois.
- Dette de revue
Le délai entre l'ouverture d'une demande d'intégration et sa relecture. Il grandit avec la taille du changement et dégrade la qualité de la lecture.
- Règle bloquante
Une règle d'analyse dont la violation empêche l'intégration, par opposition à un avertissement que tout le monde finit par ignorer.
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.