Solution

In response to these diverse challenges, Fujitsu Enabling Software Technology GmbH selected the software DITAworks from *instinctools after an extensive trial. DITAworks is a software solution that allows creation and management of different types of documentations, such as manuals, training materials, process descriptions or online help, according to the single-source principle DITA standard. DITAworks supports the entire documentation lifecycle from modeling, through creating / editing, to publishing. Once created, content can be reused in different contexts and can be published in various formats such as XHTML, PDF, RTF, Eclipse Help, DocBook. Fujitsu Enabling Software Technology GmbH deployed DITAworks solution for Eclipse which also has special functions for the documentation of Eclipse-based applications. Existing content and the model were carefully analyzed. Recommendations for the migration to the latest DITA standard and integration with the existing development and publication process as well as the XMetaL-Editor were developed. *instinctools completed the implementation of the recommendations in consultation with Fujitsu Enabling Software Technology GmbH.

Result After the existing content has been migrated to the latest DITA standard and its adoption completed in DITAworks, there are no obstacles in the immediate usage of the convenient options that DITAworks offers: The integration with the development process has taken place A plug-in for the Eclipse IDE enables the assignment of Help Contexts and synchronization with the source code ID Wizards help documentation and development teams for synchronization Dynamic Context ID Mapping supported (DTP approach) Specific transformations for Eclipse Help are available Specific validations for Eclipse Help are available With the DITA specialization for Eclipse Help, Eclipse help deliverables (such as Contexts, Live Actions and Cheat Sheets) can be defined The technical writers are working with their preferred editor Existing Eclipse Help Plug-ins can be imported. The DITAworks solution for Eclipse Help addresses the key challenges in the documentation of Eclipse RCP applications "out-of-the box". But as Fujitsu Enabling Software Technology GmbH regarding had special needs regarding migration and integration, *instinctools supported in the implementation. The editorial team of Fujitsu Enabling Software Technology GmbH is now optimally equipped for further documentation of their applications.