Rédaction structurée
Pages de la documentation sur le thème Rédaction structurée (7 pages).
Du document à la base documentaire modulaire
DITA XML permet de passer du livre monolithique à la base documentaire modulaire pour réutiliser les topics, optimiser la traduction et publier en multicanal.
Format source
Les traitements de texte nous ont déshabitués à distinguer le fond de la forme. Mais confondre les deux entraîne beaucoup d'erreurs et de perte de temps.
Formats et outils
Pour industrialiser la rédaction technique, le format importe plus que l’outil. Comparez les formats propriétaires comme Word et FrameMaker aux standards ouverts comme DITA XML et DocBook pour votre contexte.
Formats structurés et non structurés
Comparez les formats structurés (DITA XML, DocBook) et non structurés (Word, PDF) pour la documentation technique : réutilisation, traduction et évolutivité.
Les trois niveaux de la documentation technique
Comparez les trois niveaux de maturité de la documentation technique - des notes informelles au contenu modulaire structuré - et découvrez ce qui distingue chaque niveau.
Typologie de l'information
Comprendre la typologie de l'information en rédaction technique : comment Concept, Tâche et Référence structurent le contenu selon l'intention du lecteur, et comment ce principe s'articule avec DITA, Markdown et OpenAPI.
Une architecture documentaire trop complexe ?
DITA XML permet des gains de productivité en réduisant le volume source que le rédacteur technique crée, traduit et maintient, au prix d'une plus grande complexité.