DITA - The mechanics of a single sourcing project.
XML version
HTML version
PDF version
SVG versionTrack: Case Studies, Publishing, Storing XML
Audience Level: High Level/Technical View
Time: Tuesday, November 16 at 16:00
Keywords: DITA, Case Studies, Single Sourcing, Technical Documentation, Technical Writing, XML
Abstract:
The Darwin Information Typing Architecture (DITA) is an XML-based, end-to-end architecture for authoring, producing, and delivering technical information.
This paper describes how DITA-based documentation was implemented at CEDROM-SNi, one of Canada's leading on-line news content aggregators. The project delivers documentation as diverse as user training materials and Web Services reference guides targeted to programmers. We focus on the benefits, how tos, and lessons learned.
Technical documentation has its own unique challenges. Its deliverables range from simple reference guides and educational material to complex, multilingual procedure manuals. Critical success factors of a documentation project are numerous and diverse – usability, deadlines, cost, language, delivery media (paper, online) – all of which have their own purpose and challenges. This paper discusses these issues and provides a framework for future DITA projects.
