Go to content

La doc va bien, ne t'en fais pas

Présentation par : Damien Lucas 📕 Resumé : RTFM (abbréviation, péjoratif) 1. Exprime le manque de recherches sur un sujet. Relis Ton Fichu Manuel, qui n'a jamais prononcé ou entendu ce doux acronyme dans un open space ? Même si cette injonction est louable, encore faut-il avoir de la documentation à lire! Mais par où commencer ? Que faut-il documenter ? Comment structurer ma documentation ? La versionner ? Et mes schémas ? Trop de questions qui, mises bout à bout, nous empêche de faire le premier pas. Dans ce talk, je vous ferai part de mes expériences sur l'utilisation de templates de documentation et sur les outils open source permettant de générer du contenu sans effort supplémentaire. Nous aborderons : * Des templates de structure de documentation (arc42, Diátaxis) * Outils de génération de diagrammes (PlantUML, draw.io, mermaid) * Outils de modélisation (C4, structurizr) * Outils de génération de documentation (schemaSpy, springdoc, Compodoc) * Outils de publication (publisherConfluence, wiki, site statique) Enregistré en avril 2024 à Paris, Palais des Congrès, Porte Maillot. 🔥 Pour rester informé sur l'actualité de Devoxx France, suivez nous sur linkedIn : https://www.linkedin.com/company/devoxx-france/, twitter : https://twitter.com/DevoxxFR ou consultez notre site web https://www.devoxx.fr/

April 17, 2024