Our Blog

Current Articles | RSS Feed RSS Feed

Choosing the Right Technology for DITA Transformations

Submit to Digg digg it |  Add to delicious  delicious |  Submit to StumbleUpon StumbleUpon |  Share on LinkedIn LinkedIn | Submit to Reddit reddit 

I've been involved in processing XML for about 10 years. Most of that time the tool of choice for taking XML from one format (DITA, DocBook, RSS, etc.) and transforming it into another format has been XSLT.

Most of the XML transformations I've worked on involve leveraging an existing library such as the DITA open toolkit, or the DocBook stylesheets. The DocBook stylesheets are a suite of XSLT files that make it quite easy to build nice output in multiple formats (PDF, HTML, Microsoft Help), and support translating the content into multiple languages.

Some really bright folks have created some very powerful libraries with XSLT, that do make it much easier to work with DITA or DocBook and get output in multiple formats.

Anyone with the challenge of selecting a technology direction and strategy needs to consider several factors when making a decision. Here are factors I consider when making strategic technology decisions:

Suitability:
Does the technology fit the problem?
Learn-ability:
What is the learning curve for adopting the technology?
Maintainability:
How maintainable is the solution going to be?
Flexibility:
How flexible will the solution be?
Supportability:
Is there a community of experts to help and to hire?
Resilience:
Is there an exit strategy if the initial approach doesn't work out?
Cost:
How much effort and money are needed to get started and to grow?

XML gets very high marks for resilience, flexibility, and supportability, and usually, suitability.

In the area of Documentation and Learning, DITA and DocBook both allow companies to enrich content by embedding semantic intelligence in the text. An XML can allow the same content to be used in different contexts. DITA, an XML vocabulary and information architecture for documentation, also scores very high on these criteria.

What are your criteria? What else do you look at when selecting a technology for specific problem?

Next time: Ruby vs. XSLT for XML processing


Tags: , , ,

Comments

The Darwin Information Typing Architecture (DITA) is a document format, similar to the famous DocBook. DITA is being developed by IBM and OASIS is a freelance architecture and stands as a document type definition (DTD) for free. DITA is based on XML: DocBook is in contrast to the above it for any SGML-based DITA DTD. 
 
Compared to DocBook DITA is considered easier to learn. While DocBook is intended more as a template for complex books and documentation in book format, DITA pursues the objective to map technical information as topics that can be reused in different contexts. DITA also uses many elements from HTML.
Posted @ Wednesday, May 26, 2010 12:40 PM by LR
Post Comment
Name
 *
Email
 *
Website (optional)
Comment
 *

Allowed tags: <a> link, <b> bold, <i> italics