EclipseCon 2007 March 5-8, Santa Clara California

(3672) Eclipse & DITA: Write Once, Use Everywhere!

Lee Anne Kowalski (), Dave Resch (Sybase), Maria Brownstein (Sybase)

· Short Tutorial

Monday, 16:00, 2 hours | Room 211


Dave Resch

Maria Brownstein

The Darwin Information Typing Architecture (DITA) is an OASIS standard, and an emerging industry standard XML architecture for designing, writing, managing, and publishing many kinds of information in many different formats. The DITA Open Toolkit (DITA-OT) provides an open source implementation of the DITA standard DTDs and schemas, and it directly supports generating XML and XHTML files for Eclipse user assistance. The ability to create content in a single-source format and produce output in multiple formats provides great efficiencies to teams who create applications on a variety of technology platforms (Eclipse, Java Swing, .NET), and who want to generate their application help system from a common source.

This tutorial will introduce the key DITA concepts of information architecture and topic-oriented design, and guide you through the process of using DITA-XML and the DITA-OT to design, create, and deploy your content in the Eclipse help system.

Topics include:

You will walk away with the ability to use the DITA Open Toolkit to create content for the Eclipse help system, samples you can use in situations where you have to efficiently deliver content in the Eclipse help system and other formats, and a sample integration of the Eclipse platform with the DITA-OT.

Dr. Lee Anne Kowalski is IBM's User Assistance Technology Lead in the IBM Corporate User Technologies organization. Her team is responsible for developing technology and tools for use in developing user assistance mechanisms in IBM's software projects and delivering help content within software products. The team recently delivered the "IBM User Interface Help System built on Eclipse" tool as an IBM alphaWorks emerging technology, and continues to develop user assistance tools based on Eclipse technologies.

Dave Resch is a senior software engineer with the Sybase Technical Publications Solutions team. He is currently developing Eclipse-based tools for system administration and build management for a DITA-based documentation system. Before that, he was responsible for designing and developing Welcome content and implementing the original "intro framework" for the Eclipse-based IDE product, Sybase WorkSpace. Dave also worked with the doc team to migrate help content from Eclipse 3.0 to 3.1 (and now 3.2), and to migrate the Sybase WorkSpace product intro to the universal intro framework.

Maria Brownstein has over 20 years of experience in the software development and technical communications fields. Maria is currently a senior engineering manager in the Technical Publications organization at Sybase. She manages both a writing team and a development team. Her writing team is primarily responsible for developing User Assistance for the Eclipse-based developer platform product, Sybase WorkSpace, and the open-source Eclipse DTP project. The charter of the development team, Technical Publications Solutions, is two-fold, tools development and DITA transition. On the tools development side they have responsibility to define, build, and maintain a DITA-based authoring system and output mechanism that meets the needs of all Sybase pubs teams. One of the many supported outputs is Eclipse user assistance. On the DITA transition side, the team is responsible for defining the migration path to DITA, establishing and documenting DITA guidelines, and creating and delivering DITA training throughout the technical publications department.

Floor Plan

Gold sponsors

Ingres logo

BEA logo

IBM logo

Business Objects logo

Klocwork logo

Windriver logo

Red Hat logo

Actuate logo

Silver sponsors

Compuware logo

Sybase logo

Google logo






Code Gear




Innoopract logo

Lynux Works

Media sponsors

Eclipse Magazine logo logo

Methods and Tools logo

Eclipsezone logo

Addison-Wesley logo

Eclipse Magazin logo

Embedded Computing logo

SD Times logo

Enterprise Open Source logo

ACM Queue logo

TheServerSide Java Symposium

Eclipse Review logo

Software Test & Performance logo

Eclipse Developers Journal logo

Eclipse Source logo