• Like
Producing documentation for Eclipse RCP applications using single source principle
Upcoming SlideShare
Loading in...5

Thanks for flagging this SlideShare!

Oops! An error has occurred.

Producing documentation for Eclipse RCP applications using single source principle


In this presentation I highlight some basics on how DITA and DITAworks can be used when documenting Eclipse RCP applications

In this presentation I highlight some basics on how DITA and DITAworks can be used when documenting Eclipse RCP applications

Published in Business , Technology
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Be the first to comment
    Be the first to like this
No Downloads


Total Views
On SlideShare
From Embeds
Number of Embeds



Embeds 0

No embeds

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

    No notes for slide


  • 1. Experts in Information Management Solutions and Services Producing documentation for Eclipse RCP applications using single source principle Alexej Spas, instinctools GmbH June 2010
  • 2. Insights into problematic of SW Product Documentation 2
  • 3. Typical SW documentation deliverables:  Printed documentation materials (manuals, references etc.)  Application help  Context sensitive help  Documentation materials that should be published online (Online help)  Training materials  Reference documentation (API docs and s.o.)  ... other documents Most of these documents have quite a high potential for partial content reuse. 3
  • 4. Traditional Documentation Toolset 4
  • 5. Challenges we are Facing in this Scenario are:  Dealing with different source formats and redundant content  Increasing Complexity of Documentation  Globalization & Localization  Shortening of Development Cycles  High Quality Expectations  Different Target Media  Need of Integration  Increasing Demand for Documentation Variants Conclusion: Without consistent documentation methodology and appropriate tool support there is very less chance to manage all required deliverables efficiently 5
  • 6. Solution: DITA  Single source publishing as answer to these challenges.  Single sourcing allows:  same content to be used in different documents or in various formats.  labor-intensive and expensive work of editing only to be carried out once, on one source document.  further transformations to be performed mechanically, by automated tools.  One of the leading standards in XML single sourcing is DITA:  DITA stands for Darwin Information Typing Architecture  DITA was developed by IBM and donated to OASIS  DITA divides content into small, self-contained topics  DITA Topics can be reused in different deliverables.  Deliverables are modeled using special structure called map. 6
  • 7. DITA Publication 7
  • 8. DITAworks Toolset 8
  • 9. Advantages of DITAworks in This Scenario  Single-source publishing approach  Comfortable WYSIWYG editing  Generate different formats from single source  Minimize efforts spent on managing documentation variants  Increase content reuse and minimize amount of managed content  Minimize translation costs  Increase quality and consistency of documentation  Automatically build product documentation as part of product build process  Content can be pulled from 3rd party systems  Content can be published to 3rd systems 9
  • 10. Extended Eclipse Help support Highlights:  Specialized DITA types for support eclipse help and contexts  Support of live actions and cheat sheets  Cross-plugin links  Support of dynamic context ID mapping (DTP approach)  Eclipse help specific validations  In development (beta available): Tools for integration with development process. (Context IDs management between development and documentation teams)  Plug-in for Eclipse IDE  ID synchronization wizards 10
  • 11. Eclipse Help Documentation Process
  • 12. DEMO  Defining and editing new Topics  Publishing to PDF  Publishing to Eclipse Help 12
  • 13. DITAworks Use Cases Single-source publishing  Management of User Manuals  Management of Technical and product documentation  Context sensitive help and online help  Training and e-Learning materials Structured document generation & management  Contracts, Reports  RFO, RFT and other structured documents  Include data from external data sources (DBs, management systems and s.o.) Supported output formats: XHTML, PDF, RTF, EclipseHelp, JavaHelp, troff, DocBook, SCORM* *Additional information types and output formats can be defined using modeling functionality 13
  • 14. New Ideas in Information Management http://www.ditaworks.com/ Sophienstr. 17 D-70178 Stuttgart phone: +49 (0) 711 - 99 33 85 90 fax: +49 (0) 711 - 99 33 85 99 e-mail: info@instinctools.com internet: www.instinctools.com 14
  • 15. About *instinctools  *instinctools GmbH delivers Information Management solutions on Java technology since 2001, on Eclipse since 2007 Germany (Stuttgart)  Eclipse Application Design and MD Project Partner R&D Management Implementation Services Management Management Customer Sales Support  Eclipse Application Maintenance and Consulting Support Implementation Technical Product Partners  Tools for Technical Documentation Management Development Project Services (single source strategies) Belarus (Grodno)  Management Team in Germany, Software Lab near shore (Belarus)  Successfully serving premium customers like Daimler, Hubert Burda Media, Garant, EnBW and SMEs  Proven management processes and reliable project delivery infrastructure  Member of tekom, Eclipse Foundation 15