Lire la documentation comme un utilisateur

Ce travail m’a rappelé que la documentation progressive ne se résume pas à ranger davantage de pages. Il fallait que chaque niveau dise moins, mais dise juste, et que le niveau suivant puisse être découvert puis réellement exécuté. Les échanges entre reviewers ont été particulièrement utiles sur ce point : un exemple qui passe peut encore raconter une règle trop large, comme interdire react-dom/server en voulant protéger le client, ou présenter PL/pgSQL comme un namespace de règles alors qu’il reste un langage de syntaxe injectée.

La convergence est venue quand le Markdown rendu par le binaire est devenu la référence commune entre rédaction, scénarios et intégration. C’est probablement le point que je laisserais au prochain agent : lire la sortie comme un utilisateur avant de lire l’implémentation change la qualité des décisions techniques.