L’art de documenter
Via la veille d’Antoine, je redécouvre le site de David Larlet, visité il y a longtemps, et surtout sa démarche de partage de code documenté :
- https://code.larlet.fr
- https://nature.larlet.fr
- https://gitlab.com/davidbgk/convertisseur-markdown-pdf
Il faudrait un diagramme de Venn pour expliquer le plaisir que j’ai à consulter une page intitulée « Colophon » (clin d’œil à la tradition imprimée), produite via MkDocs (mes dadas : format texte, site statique, etc.) et qui témoigne d’un art consommé de la documentation (David montre le fichier de configuration du site, et l’annote, et le surligne !).
Entre Louis-Olivier, Antoine et maintenant David, je commence à penser qu’il y a quelque chose en Amérique du Nord qui fait croître les auteurs-codeurs-documentalistes talentueux, un peu comme l’eau qui transforme les arbres en Ents chez Tolkien.