Phrases d'introduction, texte de transition et autres informations de transition
Les informations de transition, telles que les phrases d'introduction, sont très redondantes dans l'architecture minimaliste de DITA, à balisage sémantique et basée sur des rubriques. Mais les informations de transition dans la contextualisation du contenu ont été remplacées par l'utilisation de blocs plus petits, de titres significatifs, de typage d'information, de structure et de libellés de démarcation générés automatiquement lors de la sortie.
Une information de transition, ou texte de transition, est un texte qui informe les lecteurs de ce qui a été abordé précédemment et de ce qui sera abordé après. En d'autres termes, l'information de transition guide le lecteur d'une idée à la suivante. En travaillant dans un système de documentation modulaire, le rédacteur ne peut pas deviner ce qui viendra avant ou après car les blocs d'informations peuvent être assemblés en différentes séquences et combinaisons pour former différentes publications.
- les transitions, par
exemple :
Dans ce chapitre...
- les phrases
d'introduction, par exemple :
Pour changer la roue :
- les phrases de transition,
par exemple :
Avant de commencer, assurez-vous d'avoir...
- les références croisées, par exemple :
Pour plus d'informations, référez-vous à...
- les marqueurs de relation, par exemple
:
Ensuite, nous allons décrire...
etAprès avoir complété la précédente étape...
- Des blocs d'informations plus petits, nommés avec des titres significatifs, permettent d'utiliser moins de phrases d'introduction, en particulier dans les rubriques tâches.
- Le typage d'information sépare les contenus qui, autrement, auraient pu être regroupés dans des rubriques distinctes, séparant ainsi les rubriques générales en rubriques concept, tâche et référence, par exemple. Cette séparation permet d'utiliser moins de texte de transition dans les rubriques.
- L'utilisation d'une structure dans laquelle la majorité du contexte du document est définie dans la ditamap plutôt que dans la rubrique, ainsi que l'utilisation minutieuse de courtes descriptions bien formées, permet aux transitions et aux informations à référence-croisée d'être générées automatiquement lors du processus de publication. Par exemple, dans une rubrique, un élément sémantique prereq peut être différentié d'un autre contenu par l'application de libellés ou d'icônes lors du processus de publication, et des tables des relations peuvent être utilisées pour former les liens vers des rubriques associées dans la sortie.
- Adopter une approche minimaliste en rédaction peut aussi permettre d'éliminer les informations de transition superflues.
En résumé, pour obtenir cohérence, cohésion et transition, il faut éviter d'utiliser du texte de transition mais au contraire se baser sur la structure, des titres significatifs et des descriptions courtes, la séparation du contexte du document dans la ditamap et le processus de publication.