DITA  - Darwin Information Typing Architecture

À la différence de DocBook où toute l'information est dans un même livre, l'objectif de DITA est de constituer des référentiels documentaires dont les contenus sont assemblables – à la demande –, dans des publications. L'idée de base est, sur un sujet donné, de créer l'ensemble des modules d'informations qui seront nécessaires à la compréhension et à "l'opérationnalité" de l'utilisateur. Ceci fait, les modules s'assemblent par configuration, soit en fonction de parcours de cet utilisateur, sur un support électronique, soit en fonction d'un ordre pré-établi, pour une publication papier.

DITA se repose sur une organisation de l'information en topics qui sont des fragments d'information autonomes ; charge aux applications d'assembler au mieux les topics pour réaliser des publications.

À la base, il existe trois types de topics : concept, tâche et référence, tous trois dérivés d'un topic de base. Cette spécialisation permet au rédacteur de se pencher sur la nature de l'information qu'il écrit, et par là-même, de la rendre réutilisable dans différents contextes.

• Concept

  La notion de concept doit permettre de répondre aux questions suivantes :

  • Qu'est-ce ?
  • Pourquoi est-ce important pour moi ?
  • Comment est-ce lié à d'autres concepts ?
  • Quand dois-je l'utiliser ?
• Tâche

  La notion de tâche permet de guider l'utilisateur d'un point à un autre en répondant à la question "comment faire cela ?"

  La notion de tâche différencie :

  • le contexte,
  • les pré-requis,
  • les étapes de la tâche,
  • les post-requis,
  • le résultat obtenu.
• Référence

  Permet de donner de l'information de référence, par exemple des listes d'identification de variables ou des listes de commandes. L'idée : "passons à l'essentiel".

Ces quatre topics (un généraliste et trois spécialisés) sont prévus pour pouvoir être eux-mêmes dérivés, de façon à mieux coller aux structures des entreprises réalisant de la documentation avec DITA. Par ailleurs, il est aussi possible d'étendre le modèle documentaire accessible dans un topic particulier ou pour tous les topics d'une entreprise : on parle alors de "spécialisation de domaine".

Enfin, DITA repose sur un jeu d'objets connus et réutilisables : les Métadonnées de chaque topic utilisent autant que faire se peut le Dublin Core ; les modèles de contenu utilisent les tableaux OASIS Tables et une base rédactionnelle non spécialisée liée à XHTML.

Pour finir, la question que devra se poser toute personne souhaitant utiliser ce standard est la suivante : "comment ferai-je pour retrouver un topic particulier parmi les 1000 modules de données (10 000 modules ?) que j'ai dans ma base de données ?". DITA étant une spécification liée à l'industrie du logiciel, il ne peut – par essence – pas exister de référentiels génériques de classement des topics pour n'importe quel produit logiciel. On peut alors se reposer sur des classifications qui mixent des natures d'information (un "getting started", par exemple) avec des objets composés utiles à l'utilisateur (par exemple : "pour comprendre ce concept, il faut, d'une part sa définition (un topic), d'autre part, un exemple (un autre topic) et, enfin, un "how-to" expliquant comment le mettre en place (un nouveau topic)").

La méthode proposée par DITA repose sur les "maps" qui deviennent aussi spécialisables ; leurs fonctionnement et rôle est défini dans la notion de "design patterns" de DITA. Il devient alors possible de considérer qu'un fonds documentaire est composé d'un ensemble de maps qui sont, par la suite, assemblées pour réaliser des publications. La structure de stockage dans un fonds documentaire est alors la map, accessible selon des classifications fonctionnelles-produit (question : "quelle est la fonction décrite ?").