Utiliser un framework pour écrire de la documentation ?

Et si il suffisait d'un peu de méthode et d'organisation pour que la doc devienne agréable à utiliser mais aussi à écrire ?

Au travers d'exemples culinaires simples à appréhender, nous verrons comment organiser sa documentation, comment mettre les auteurs en confiance, et comment écrire une documentation qui sera lue !

Le framework Diátaxis est encore peu connu mais il a déjà fait ses preuves chez de grands éditeurs de logiciels et j'ai eu l'occasion de le mettre en place dans une équipe technique de 60 personnes. Nous nous appuierons sur cette expérience pour montrer que la doc, ce n'est pas qu'une suite de mots et qu'on peut lui donner du sens.

Comments