Typage de l'information
Pages de la documentation sur le thème Typage de l'information (6 pages).
Ce thème regroupe 6 pages dans le manuel :
Parcours : 5. Constituer votre boîte à outilsExemples concrets
Un exemple abouti d'article concept en Markdown, annoté pour expliquer pourquoi chaque choix structurel a été fait.
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é.
Modèle : article concept
RéférenceParcours : 5. Constituer votre boîte à outilsModèles
Un modèle de rédaction prêt à l'emploi pour concevoir un article concept — un type d'information répondant à « Qu'est-ce que c'est ? » avec définitions, contexte, principes et exemples.
Modèle : article référence
RéférenceParcours : 5. Constituer votre boîte à outilsModèles
Un modèle Markdown prêt à copier pour rédiger un article référence, selon la structure Aperçu / Syntaxe / Paramètres / Exemples / Limitations.
Modèle : article tâche
RéférenceParcours : 5. Constituer votre boîte à outilsModèles
Un modèle Markdown prêt à copier pour rédiger un article tâche/didacticiel, selon la structure Objectif / Prérequis / Étapes / Résultat attendu / Dépannage.
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.