Segmenter l'information en rubriques

Les documents peuvent être décomposés en plus petits segments de contenu qui peuvent être traités comme des sous-ensembles modulaires. Ces doivent être organisés en différents fichiers de rubriques.

Dans les documentations basées sur des rubriques, la décomposition et la segmentation de l'information en rubriques sont particulièrement importantes. Un guide utilisateur qui comporte une très longue rubrique organisée en plusieurs sections est peu segmenté. Les rubriques doivent être des unités de contenu granulaires courtes et autonomes. En règle générale, plus une rubrique est courte, plus elle est susceptible d'être réutilisée dans un autre document livrable.

Le processus de segmentation consiste à analyser les composantes de l'information à documenter, à identifier les blocs de contenu qui constituent des unités d'information autonomes, puis à séparer ces unités en différents segments.

Dans DITA, les segments autonomes peuvent être organisés en rubriques, en sections au sein de rubriques, ou en rubriques au sein de rubriques. Efforcez-vous de créer une rubrique par segment et évitez les sections et les assemblages de rubriques.

L'information contenue dans une rubrique source DITA ne doit pas nécessairement être livrée en respectant la même granularité. Il est par exemple possible de publier un ensemble de rubriques DITA au sein d'une seule rubrique HTML (l'attribut chunk dans l'élément topicref, contenu dans les cartes DITA, est prévu à cet effet).