2 articles tagués avec « Documentation en ligne »

Je crée de l’aide en ligne depuis les débuts — à l’époque où HTML régnait et où les éditeurs étaient en essentiellement en texte brut. Beaucoup de choses ont changé, mais certains fondamentaux restent solides.
Dans cet article, je retrace l’évolution de l’aide en ligne, de RoboHelp et des structures en trois frames jusqu’à l’univers plus épuré du Markdown et des générateurs de sites statiques. Un mélange de nostalgie, de pragmatisme — et toujours dans l’objectif d’améliorer la documentation.

Cet été, je me suis replongée dans la documentation d’un client avec une double mission : expliquer leur nouvelle API et migrer l’ensemble du site vers Docusaurus V2.
Du moteur de recherche aux admonitions stylisées en passant par l’intégration ReDoc, cette version ne se contente pas d’être belle — elle fonctionne brillamment. Voici ce que nous y avons gagné, et ce à quoi il faut faire attention.