Chapter 4 · Chapitre 4 · Vérification 3 : la démonstration
4.1 Pourquoi tester plutôt que croire
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeCertaines affirmations ne se vérifient pas dans un texte : elles se vérifient en essayant. Dès que ton contenu dit « lance cette commande et il se passe ceci », la meilleure preuve est de lancer la commande et de regarder ce qui se passe.
C'est aussi ce qui donne de la valeur à ton contenu. Ton audience sent la différence entre quelqu'un qui récite une description et quelqu'un qui montre un vrai résultat, avec une vraie sortie de terminal (le texte que la commande affiche en réponse).
Ce que le test apporte que la doc n'apporte pas
- Il confirme le comportement sur ta version de l'outil.
- Il révèle les détails que la description oublie (un message, un code de sortie, une étape intermédiaire).
- Il te donne une preuve à montrer : une capture, un avant/après.
Ce que la doc apporte que le test n'apporte pas
Le test et la documentation se complètent. Un test te montre ce qui se passe chez toi, une fois. La documentation te dit ce qui est prévu, dans quels cas, avec quelles limites. Un test réussi ne prouve pas qu'une fonction marche partout, et un test raté ne prouve pas qu'elle n'existe pas (tu as peut-être mal tapé la commande). C'est pour ça qu'on fait les deux quand c'est possible.
Les règles d'un bon test
- Un dossier de test, jamais ton vrai projet. Un test peut modifier ou supprimer des fichiers.
- Un état de départ connu : tu sais exactement ce qu'il y a dans le dossier avant de lancer la commande.
- Une seule chose à la fois : une commande, un résultat observé.
- Une observation précise : « le fichier a-t-il changé ? » plutôt que « est-ce que ça marche ? ».
- Une trace : la commande, la sortie, la version, la date (leçon 4.4).
Préparer un test avec Claude Code
Tu n'as pas besoin de savoir écrire le test toi-même. Demande-lui de le concevoir, sans le lancer :
Pour cette affirmation : « prettier --check corrige automatiquement les fichiers »,
propose un test court à faire dans un dossier de test vide :
1. les étapes, avec les commandes exactes ;
2. ce qu'on doit observer pour conclure vrai ou faux ;
3. comment vérifier que le fichier a changé ou non.
Ne lance rien pour l'instant et ne dis pas que le test est fait.
Relis le plan. Si une commande te semble risquée ou incompréhensible, demande une explication avant de la lancer. Le mode plan de Claude Code est fait pour ça : Claude lit et rédige un plan sans modifier tes fichiers avant ton accord. Tu peux y entrer avec /plan suivi de ta demande.
Ce qu'on ne teste pas
Certaines affirmations ne se testent pas, ou pas raisonnablement :
- Une promesse de résultat (« tu vas gagner des abonnés ») : aucun test unique ne la confirme.
- Une durée garantie (« en 5 minutes ») : elle dépend de la personne et du projet.
- Une action irréversible sur de vraies données (publier, supprimer, payer) : on ne teste pas en production.
Pour celles-là, la bonne correction est souvent de retirer ou de nuancer (chapitre 5).
Si ça coince
- Tu as peur de casser quelque chose. Crée un dossier vide dédié, et ne teste rien ailleurs. Si un fichier de test est abîmé, ce n'est pas grave.
- Le test donne un résultat inattendu. Relis la commande caractère par caractère, puis compare avec la documentation. Une faute de frappe ressemble souvent à un bug.
- Claude Code dit que le test est réussi. Regarde la sortie toi-même. C'est la sortie qui prouve, pas son résumé.
À retenir
- Ce qui est technique se teste.
- Un vrai résultat montré vaut mieux qu'une description répétée.
- Test et documentation se complètent : l'un montre, l'autre explique.
- Toujours dans un dossier de test, une chose à la fois, avec une trace.