L'autodidacte

Documentation vivante

La documentation vivante, c'est une doc qui reste vraie parce qu'elle est branchée sur la réalité du système : générée ou vérifiée depuis le code, les tests, les schémas, plutôt qu'un document figé qui pourrit dès qu'on le referme. Sa promesse : ne pas te mentir, parce qu'elle n'a pas le temps de vieillir.

Face à une doc morte qui décrivait une version disparue, tout ce que je cherchais, c'était une source qui vieillisse moins vite que la mémoire des gens.

À lire : Faire avouer un système.