Quel niveau de détails dans une rubrique ?

Une rubrique DITA doit être aussi courte que possible, mais suffisamment longue pour transmettre une information, indépendamment des autres rubriques.

On désigne parfois la quantité d'information traitée par rubrique dans une publication comme étant la granularité des rubriques. Une rubrique DITA ne doit contenir qu'une seule idée ou ne répondre qu'à une seule question.

Il arrive parfois qu'une rubrique soit extrêmement courte, comme ci-dessous avec l'exemple d'une procédure d'urgence prescrite pour un avion de chasse.

<task>
<title>Panne moteur en dessous de 10 000 pieds</title>
<taskbody>
 <steps>
  <step><cmd>Éjectez-vous.</cmd></step>
 </steps>
</taskbody>
</task>

Dans d'autres cas où une rubrique contient une procédure ou un concept très complexe, un glossaire détaillé, ou une longue table de référence, la longueur de ladite rubrique peut être de plusieurs pages. Par exemple, une rubrique de type référence listant tous les modèles et marques de voitures sortis au XXe siècle sera longue de plusieurs pages, mais ne traitera que d'un seul sujet.

Une rubrique doit être la plus courte possible, tout en étant suffisamment longue pour être indépendante des autres rubriques. En d'autres termes, elle doit se suffire à elle-même, quel que soit le contexte.