Aller au contenu
CONTACT

Loi de la documentation posthume

PROGRAMMATION ET BUGS

La documentation, quand elle existe, décrit avec une grande précision la version précédente du programme.

— Anonyme, folklore informatique
VIDEO.EXE16:9

La documentation technique est un genre littéraire à part entière, entre le roman historique et le testament. Elle raconte avec force détails un monde qui n'existe plus : des boutons déplacés, des menus renommés, des fonctions supprimées entre-temps lors d'une réunion de quatre minutes.

La raison est simple. Le code court, la documentation marche. Quand quelqu'un écrit enfin le manuel de la version deux, les programmeurs se disputent déjà sur la quatre.

J'ai un client qui conserve le manuel de son logiciel de gestion dans une vitrine, comme une relique. De temps en temps, il l'ouvre et lit les instructions à voix haute, d'un ton solennel. Aucune ne correspond plus à l'écran. Mais il dit que ça l'aide à se souvenir du monde tel qu'il était quand les boutons étaient à gauche. Et moi, franchement, je le comprends.