Rédaction structurée
Pages de la documentation sur le thème Rédaction structurée (7 pages).
Ce thème regroupe 7 pages dans le manuel :
Parcours : 4. Choisir un modèle de rédaction
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
ConceptParcours : 4. Choisir un modèle de rédactionFormats source et cible
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
ConceptParcours : 4. Choisir un modèle de rédactionFormats source et cible
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.
Parcours : 4. Choisir un modèle de rédactionRédaction structurée
Comparez les formats structurés (DITA XML, DocBook) et non structurés (Word, PDF) pour la documentation technique : réutilisation, traduction et évolutivité.
Parcours : 1. Comprendre la documentation
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.
Types d’information
ConceptParcours : 1. Comprendre la documentation
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.
Parcours : 4. Choisir un modèle de rédactionDITA
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é.