Que permet la norme DITA pour votre gestion documentaire ?

Publicité

DITA (Darwin Information Typing Architecture) est un standard ouvert, maintenu par l’OASIS, qui permet de rédiger, organiser et publier de la documentation technique à partir de contenus XML découpés en petits modules réutilisables. Ce n’est pas un logiciel : c’est une norme que des outils, notamment les systèmes de gestion de contenu par composants (CCMS), mettent en œuvre. Sa structure rigoureuse est particulièrement adaptée pour les entreprises qui produisent beaucoup de documents. Voici ce qu’elle apporte concrètement à votre gestion documentaire.

Norme DITA : la création de documents techniques

Avec DITA, tous les contenus sont écrits en XML. Si vous ne maîtrisez pas ce format, un éditeur XML avec une interface visuelle permet de rédiger sans manipuler directement le code. Un même contenu peut ensuite être publié en HTML, en PDF ou dans d’autres formats. Un outil adapté offre en plus un suivi de l’ensemble de votre documentation : vous retrouvez facilement un fichier et en avez une visualisation rapide. Tout ceci est applicable avec la Suite Dita Factory.

Des contenus structurés et hiérarchisés

DITA repose sur deux notions simples :

• le topic, un module autonome qui traite un seul sujet (une procédure, un concept, une référence) ;
• la map, qui assemble et ordonne les topics pour composer un manuel, une aide en ligne ou un guide.

Cette organisation rend la documentation plus lisible et plus cohérente. Elle permet aussi de classer les contenus selon les critères que vous avez définis au préalable (produit, version, public, langue).

Réutilisation, publication et diffusion

Un topic écrit une seule fois peut servir dans plusieurs documents : il suffit de le référencer, sans le copier. Vous évitez ainsi les doublons, les écarts entre versions et le travail de mise à jour répété. Une modification faite à la source se répercute partout où le contenu est utilisé. Le filtrage par attributs permet en outre de produire plusieurs variantes d’un même document (selon le modèle d’un produit ou le profil du lecteur). Les contenus peuvent être publiés sur papier, en PDF ou en ligne, à partir des mêmes sources.

Pourquoi choisir DITA, et à quelles conditions ?

DITA réduit le coût de production et de maintenance de la documentation, et facilite la traduction, puisque seuls les modules modifiés sont à retraduire. Le standard peut aussi être spécialisé pour s’adapter à un secteur ou à une organisation. Pour réussir sa mise en place :

• définissez d’abord vos types de documents et vos règles de rédaction ;
• formez les rédacteurs à l’écriture modulaire, qui change des habitudes d’un traitement de texte ;
• commencez par un projet pilote avant de migrer tout l’existant ;
• évitez de découper à l’excès : un topic doit rester compréhensible seul.

Pour un volume documentaire réduit, DITA peut être plus lourd que nécessaire : il prend tout son sens lorsque les contenus sont nombreux, répétitifs ou multilingues.