ARTICLES
Tous les articles publiés sur Les Joies du Code

Développeurs : pour mettre fin à notre calvaire, écrivons des docs claires !

Deadpool et Wolverine, peut-être qu'ils vont écrire une documentation technique on sait pas hein

Read the fucking manual — Ah, la documentation technique. Bien souvent négligée, parfois farouchement défendue… Ce qui est sûr, c’est qu’elle ne laisse aucun développeur de marbre.

Je ne vais pas vous le cacher, ça fait longtemps que je souhaite traiter ici ce sujet (et qui sait, peut-être d’autres), même si celui-ci s’avère un peu plus sérieux que mes contenus habituels.

Alors on en rigole, c’est sûr... Mais dans le fond, la documentation — et je parle notamment de la documentation technique — c’est quand même quelque chose qui nous concerne de manière très concrète et qui joue un rôle crucial dans les projets de développement.

D’ailleurs, si on y réfléchit bien, celle-ci (ou ne serait-ce que son existence) peut carrément avoir un impact sur notre organisation, notre productivité, et même notre bien-être (si, si) !

Lire l'article →