Éviter la segmentation au sein des rubriques

La hiérarchie de la segmentation de l'information et la séquence segmentée doivent apparaître dans les collections publiées. Elles doivent aussi être définies dans la carte DITA et non dans les éléments section ou les rubriques imbriquées.

Dans ce contexte, un segment est un bloc identifiable ou une unité d'information et la segmentation est le processus d'organisation de l'information en unités.

DITA possède un élément section, utilisé afin de diviser des rubriques en sous-ensembles d'information directement liés à la rubrique. Lorsque vous rédigez un contenu dans DITA, deux options s'offrent à vous : vous pouvez segmenter l'information dans des rubriques séparées ou utiliser une rubrique unique et segmenter l'information en sections au sein de cette rubrique.

Dans la plupart des cas, il est préférable de choisir de simples rubriques séparées plutôt que des sections.

Il est recommandé d'éviter les éléments section car ceux-ci ont pour résultat d'inclure la hiérarchie et la séquence (structure du document) dans la rubrique. Si un segment de contenu est inclus dans une section plutôt que dans une rubrique, il apparaît toujours dans la même séquence au sein de la rubrique contenant. Structurée sous forme de rubrique, l'information peut apparaître dans n'importe quelle séquence, hiérarchie, collection.

Les sections sont plus difficiles à réutiliser ; plus un document sera granulaire, plus les possibilités de réutilisation seront élevées.

Les sections peuvent être appropriées pour les rubriques uniques dans lesquelles l'idée complète comporte de nombreux aspects. DITA ne permet pas d'avoir des sections au sein de sections (sections imbriquées).

Il est techniquement possible d'imbriquer des rubriques d'information de différents types au sein d'une rubrique de type ditabase (ou assemblage). Toutefois, la rubrique ditabase n'est pas destinée à cet effet. Elle devrait uniquement être utilisée pour contenir des éléments réutilisables pour les types d'information mixtes.

Utiliser des rubriques DITA séparées ne signifie pas que les rubriques doivent être générées en tant que rubriques séparées dans la sortie. Si nécessaire, les rubriques source DITA peuvent être regroupées dans une seule rubrique de sortie, par exemple, grâce à l'attribut segmentation dans la carte DITA topicref.

La carte DITA est le meilleur moyen d'enregistrer la hiérarchie et la séquence.