Paragraphes dans les rubriques de référence

Les éléments paragraph (p) ne doivent pas être utilisés dans les rubriques de référence. En effet, par définition, ces dernières contiennent des faits et non des idées.

Les rubriques de référence sont conçues pour contenir des données précises qui sont généralement organisées sous forme de tableau. Selon cette définition, les éléments paragraph, dont le contenu est un texte narratif et non des données précises, n'ont normalement pas leur place dans une rubrique de référence.

La norme DITA interdit l'insertion d'éléments p dans le corps d'une rubrique de référence, sauf si ces derniers sont placés dans des éléments tels que refsyn et section.

N'utilisez pas de contournements pour insérer un paragraphe. Par exemple, n'imbriquez pas d'éléments p dans des sections dépourvues de titres. Évitez d'insérer plusieurs paragraphes dans les descriptions de syntaxe (c'est-à-dire dans les éléments refsyn), puisque ces éléments sont censés contenir des descriptions courtes.

De même que pour les autres types d'information, évitez autant que possible d'utiliser les éléments section.