La arquitectura DITA

DITA es una arquitectura basada en lenguaje XML para la creación de contenidos, organización y gestión de documentación técnica; fue desarrollada originalmente por IBM para gestionar la elaboración de documentación técnica y cedida a OASIS (Organización para el Avance de los Estándares de Información Estructurada) en 2005 como estándar abierto neutro e independiente de cualquier herramienta o sistema informático.

Objetivos del estándar DITA

  • organizar la información de forma coherente
  • facilitar la producción de diversos tipos de documentos a partir contenidos compartidos
  • independizar el contenido de la presentación (aspecto formal)
  • producir automáticamente documentación en distintos formatos (PDF, HTML5, EPUB, etc) desde un mismo contenido
  • simplificar y gestionar eficazmente de los procesos de documentación

En resumen, DITA sirve para definir la estructura de la información mediante el etiquetado semántico de acuerdo con criterios de modularidad, para facilitar la reutilización de contenidos y el intercambio y producción de distintos tipos de documentación.

Conceptos básicos de la arquitectura DITA

Artículo (topic)

  • es la unidad básica de contenido
  • es completo
  • es independiente del contexto para facilitar su reutilización
  • puede ser genérico o encuadrarse en alguna de las categorías ya predefinidas

Mapa es la estructura que define los componentes y la jerarquía de artículos que constituyen un determinado documento

Procesado condicional son las reglas que especifican los criterios por los que se incluyen o excluyen determinados elementos de los artículos en función del tipo de documento final (por ej. guía de introducción o manual de usuario) y su formato (por ej. PDF para imprimir o HTML5 para web)

Producción es el proceso realizado por una aplicación informática para generar de forma automática los documentos a partir del mapa o mapas, aplicando las reglas de procesado condicional y las hojas de estilo (stylesheets)

Beneficios para la Empresa

La adopción del modelo DITA para la gestión de la documentación técnica aporta los siguientes beneficios :

  • acortar el tiempo disponibilidad comercial del producto (adaptar la metodología Agile a la documentación para no retrasar el desarrollo del producto)
  • aumentar la calidad percibida del producto (contenidos coherentes y de calidad)
  • reducir costes del producto (costes de localización/traducción) debido a :
    • menos volumen a elaborar
    • más rapidez de elaboración
    • utilizar recursos menos costosos

Alternativas a DITA

El conocimiento de los principios básicos de DITA resulta muy útil para comprender el significado práctico del concepto “contenido estructurado”, aunque a la hora de afrontar un proyecto concreto no hay porque seguir estrictamente el modelo DITA. Existen herramientas comerciales que ofrecen un mayor o menor grado de compatibilidad con DITA pero que permiten trabajar con modelos más sencillos perfectamente adecuados en la mayoría de los casos. En este aspecto, las ventajas de DITA son la portabilidad y compatibilidad al tratarse de un modelo abierto independiente de las arquitecturas propietarias que obligan a trabajar con sus propias herramientas.

¿Quiere conocer más sobre DITA y su aplicación en la Documentación técnica? Contacte con nosotros hoy mismo.