DITA + Wiki = The Open-Source DITA2Wiki Project
In early 2005, the Information Development group at Lombardi Software, Inc. set out to implement a single-system solution for three business problems; Lombardi's user community had a lot of knowledge to share but didn't have a forum to do so; there was no facility to deliver and discover updates to the product documentation in between releases; and, there was no efficient feedback loop that could help drive improvements into the product.
The DITA2Wiki Framework
At a high level, the DITA2Wiki framework consists of two components:
The Business Process
The DITA2Wiki framework implements two repeatable business processes. One process handles company-generated content (referred to as "warrantied" content), and one for community-generated content (referred to as "non-warrantied" content).
When community members want to find help with a particular task or feature, they can search all content types or filter search results based on specific conditions. The documentation and community content can be interlinked and labeled to aid information discovery.
Process for company-generated content:
Process for community-generated content:
The tooling consists of the following components:
To get started on implementing the DITA2Wiki framework, download and install an evaluation version of the target wiki, and the open-source DITA2Wiki binary distribution and its open-source prerequisites. Visit the DITA2Wiki Project wiki for complete instructions (see section REFERENCES).
Can I Use the DITA2Wiki Framework with Any Wiki?
The DITA2Wiki Project distributions currently support the Confluence Enterprise wiki (because of legacy reasons; Lombardi Software uses Confluence). But the implementation can be customized to support other wikis, and this is a goal of the open-source DITA2Wiki Project.
The primary areas to customize are:
Lisa Dyer manages the Information Development group at Lombardi, Inc. (http://www.lombardisoftware.com/). She also runs the Lombardi Wikis system, in which DITA content and wiki content are mashed up to provide a rich source of community-generated and company-generated content.