Les équipes techniques cherchent souvent un système de documentation qui soit à la fois structuré, versionnable, recherchable et maintenable dans la durée. Confluence devient vite coûteux, GitBook a des limitations sur les plans gratuits, et Notion ne s'intègre pas naturellement dans un workflow Git.
Pourtant, Drupal dispose de tous les ingrédients pour être un excellent système de documentation : hiérarchie de contenu avec le module Book, gestion fine des permissions, révisions de contenu, recherche avec Search API, API REST ou GraphQL pour une consommation externe, et un éditeur CKEditor 5 extensible.
Cette session de 40 minutes part d'un Drupal vierge pour arriver à une base de documentation technique complète. Nous intégrerons Mermaid dans CKEditor 5 pour permettre aux rédacteurs d'insérer des diagrammes directement dans leur contenu, mettrons en place un workflow docs-as-code (rédaction en Markdown, synchronisation depuis Git), configurerons la recherche, et verrons comment exposer la documentation via l'API pour d'autres consommateurs (app mobile, CLI, IDEs).
