Go to content

[DevFest Nantes 2017] Documentation as Code (expliqué à mon père)

Speaker : Hubert Sablonnière (Open Devise) En tant que codeurs, nous profitons tous les jours de la puissance de nos outils (IDE, versioning, build, intégration, déploiement). Nous mettons également l’accent sur la qualité avec un ensemble de bonnes pratiques (tests, DRY, KISS). Néanmoins, lorsqu’il s’agit de s’occuper de la documentation, nous sommes encore nombreux à utiliser des outils de "bureautique traditionnelle" (Word, Sharepoint, client email). "Au menu de cette session, je vous propose d’aborder le langage AsciiDoc ainsi que l’outil asciidoctor (et son ecosystème). Nous verrons quels avantages ils apportent et quelles "pratiques de codeur" appliquer pour améliorer les différentes étapes de la vie d’une documentation : rédaction, collaboration et publication."

October 19, 2017