Hiérarchiser les rubriques

Une hiérarchie de rubriques bien conçue facilite la recherche d'informations des lecteurs.

Structurer le contenu d'un document est l'une des étapes les plus importantes du processus rédactionnel. C'est lors de cette étape que vous établissez les relations logiques entre les rubriques, et que vous ajoutez le contexte à l'ensemble des rubriques.

Prenez en compte les aspects théoriques suivants lorsque vous décidez de la structure des rubriques :
  • L'esprit humain peut manipuler environ quatre concepts à la fois.
  • Les humains prennent de meilleures décisions quand ils sont confrontés à sept choix (loi de Miller)1

Appliqués à la structure documentaire, ces aspects théoriques définissent une structure idéale de rubriques parentes contenant chacune sept rubriques enfants à chaque niveau, avec pas plus de niveaux de rubriques.

Une hiérarchie possédant trois niveaux de sept rubriques permet d'obtenir 343 pages. Quatre niveaux de dix rubriques offrent jusqu'à 10 000 pages, ce qui est plus que suffisant, même pour les guides utilisateur les plus volumineux.

L'être humain ne pense pas de façon linéaire, mais plutôt par association d'idées. C'est pourquoi nous nous égarons et oublions comment nous en sommes arrivés à tel sujet. Le cerveau humain stocke également les informations de cette façon, en cherchant une expérience précédente similaire et en l'associant à l'expérience en cours.

Dans DITA, les informations de concept sont distinctes des informations de tâche et de référence. Structurer un document selon les attentes du lecteur devient alors plus difficile, à moins que la nature de l'information permette la création d'ensembles standard, composés d'un concept, d'une tâche et d'une référence. Ce type de modèle permet la création d'une table des matières de ce type :
  • Démarrer
    • Principes du moteur (concept)
    • Démarrer le moteur (tâche)
    • Spécifications du moteur (référence)
Le groupement des rubriques de concept, de tâche et de référence est une approche alternative qui génèrerait une structure comme celle-ci :
  • Concepts de la voiture
    • Démarrer
    • Conduire
    • S'arrêter
  • Tâches de la voiture
    • Démarrer
    • Conduire
    • S'arrêter
  • Informations de référence sur la voiture
    • Démarrer
    • Conduire
    • S'arrêter

Toutefois, la plupart des modèles d'information n'ont pas vraiment ce type de structure répétable. On trouve plus facilement une rubrique de concept liée à trois ou quatre rubriques de tâches et une rubrique de référence liée à une douzaine de concepts.

Il n'est pas évident de décrire la structure idéale d'un document spécifique. La responsabilité de l'auteur est donc de concevoir une structure logique adaptée aux objectifs du document final.

Lorsque vous concevez la table des matières et la structure de vos rubriques, posez-vous les questions suivantes :
  • Quel niveau de détail sera utilisé ?
  • Combien d'informations comprendra chaque nœud ?
  • Quel nœud sera relié à quel nœud ?
  • Quel type de lien sera utilisé ?
  • Quelles entrées seront nécessaires ?

Suivez également ces deux lignes directrices distinctes :

  • Concevez votre structure avec un seul nœud au sommet de l'arborescence (une rubrique mère) qui relie toutes les autres rubriques. Cela permettra de rendre cohérent le fil d'Ariane des liens et des autres chemins de navigation.
  • N'utilisez pas des titres sans contenu (les éléments topichead) dans la carte. Utilisez plutôt les rubriques d'introduction ou de résumé. Le processus de publication permet de constituer automatiquement le contenu de ces rubriques d'introduction en se basant sur les descriptions (shortdesc) de ses rubriques enfants.
1 Miller, G. A. (1956). The magical number seven, plus or minus two: Some limits on our capacity for processing information. Psychological Review, 63(2), 81-97.