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 pour la compréhension et pour "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.

Le maître mot est alors la réutilisation : concevoir des granules d’informations qui puissent être réutilisables dans différentes documentations-produit.

La réutilisation se conçoit par ailleurs dans une idée d’applicabilité : pouvoir concevoir des granules d’informations réutilisables dans différentes configurations documentaires.

Pour répondre à ses objectifs, DITA s’appuie sur une réelle architecture documentaire et pour les concepteurs, il existe peu d’installations qui n’utilisent que le socle standard sans l’avoir étendu. En effet, ce socle est toujours spécialisé pour avoir des publications respectant la charte graphique d’entreprise. Ce socle est aussi souvent spécialisé pour mieux identifier de nouveaux composants documentaires ou de nouveaux types de topics.

Dans DITA, tout nouvel objet n’est qu’une extension d’un objet DITA de base connu. Il existe alors dans le standard trois types de topics de base : concept, tâche et référence, tous trois dérivés d'un même 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 topics (un généraliste et trois spécialisés) sont donc prévus pour être spécialisés, de façon à mieux coller aux structures des entreprises réalisant de la documentation avec DITA.

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".

DITA repose sur un concept de découpage de l’information en fragments autonomes représentés par des topics. Une publication est alors l'assemblage de l'ensemble des fragments (topics) nécessaires pour fournir l'information adéquate à un utilisateur donné, sur un produit donné.

Enfin, DITA repose sur un jeu de métadonnées connues 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.

Dérivée des architectures objets, la notion de spécialisation propre à DITA est une méthode qui garantit que tout nouvel objet introduit dans un modèle d’entreprise a, au minimum, un comportement de base standard. Pour ce faire, il doit obligatoirement dériver d’un objet connu de l’architecture DITA. C’est ce comportement – par défaut – qui garantit l’échange entre systèmes hétérogènes et son interprétation.

Les objets de base ont tous une représentation graphique : un paragraphe, un item de liste, une mise en valeur, une section titrée, etc. N’importe quel processeur DITA peut alors représenter cette information à l’écran, pour un plus grand confort de lecture. Naturellement, cette représentation est elle-même être spécialisée et le DITA Open Toolkit offre une bonne démonstration de la bonne façon d’utiliser cette architecture.

Du coup, toute spécialisation définit, par son héritage, la façon dont se présente l’objet. La démarche a son intérêt, car l’effort de paramétrage pour une spécialisation est alors faible. La démarche a cependant ses limites, dès lors que l’on manipule des objets qui n’ont pas de représentation directe.

La spécialisation permet à un ensemble d'entreprises d'utiliser un cadre de référence commun tout en se permettant de mieux adapter les concepts sous-jacents à leurs besoins – tant en termes d'ingénierie documentaire qu'en termes d'organisation documentaire.

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 1 000 modules de données (voire même 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 doit 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 me 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)").

Les maps jouent alors un nouveau rôle : elles permettent d’assembler des topics élémentaires en éléments autonomes et cohérents d’informations publiables. 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.