Aller au contenu

Revoir la documentation, de zéro

Par Matthias Dugué

Conférence (50 mn) :
Salle :
Auditorium Blaise Pascal
Service(s) :
LSF
Vélotypie
Langue :
Français

Le sujet

Nous ne sommes pas une jeune pousse. Avec plus de douze années d'existence, nous connaissons à la fois très bien notre travail, et nos utilisateur·trice·s. Et pourtant ! malgré nos réelles compétences, nous avons laissé aller notre documentation technique à destination de ces mêmes membres de notre communauté.

C'est pourquoi nous avons fait le choix, peut-être audacieux, de repartir de zéro ! Cette conférence est un retour d'expérience à propos de ce que nous avons appris, de nos erreurs passées, de nos choix d'outils, de nos workflows, et de notre capacité à délivrer une vraie documentation technique pour et avec notre communauté, française et internationale. Voyons comment fonctionne une bonne documentation technique inclusive chez un acteur PaaS moderne.

Ce projet est un "WIP talk" : nous rebâtissons cette documentation en même temps que nous préparons la conférence. Nous ne connaissons pas la fin, nous la mettons à jour au fil de l'eau. Cela garantit à la fois son authenticité, et la qualité de son retour d'expérience.

Présenté par