Aller au contenu

La dette de documentation reste une dette d’infrastructure

Vous vous rappelez ce que les gens disaient de la documentation quand ils ne voulaient pas assumer la responsabilité de l’infrastructure ou du code ?

« Ouais, je sais que c’est important... mais on a tellement de vrai boulot à faire. »

Vous croyez que des gens parlent encore comme ça ?

C’est vrai. Mais on a toujours 90 secondes dans sa journée pour dire à une machine de documenter ses PR, de synchroniser ses pages Confluence avec ses feuilles de calcul, ou de suivre l’état de ses patchs et de ses logs.
Il n’y a plus d’excuse.

Sauf... si vous n’en avez jamais rien eu à foutre de la documentation.
Certaines boîtes (on sait tous de qui on parle) ne travaillent pas plus dur, mais elles sont fortes pour avoir l’air occupées.

Voyez-vous, les silos d’information sont l’arnaque parfaite.

Les dirigeants n’y connaissent rien. Tout ce qu’ils voient, c’est un nombre élevé de tickets, et ils en déduisent que c’est productif.

Vous pensez qu’ils verraient les choses différemment s’ils savaient que vous êtes en train de cramer la baraque ?

J’imagine que le logiciel d’entreprise a toujours été comme ça.

C’est juste plus bruyant maintenant.

Plus flagrant.
Et tellement plus facile à pister.