Charter

The purpose of the RTP DITA Users' Group is to facilitate communication and the sharing of knowledge between DITA users in the Research Triangle Park (RTP) area of North Carolina.

Meetings

We meet on the fourth Wednesday of each month from 5:30-6:30 PM. Currently our meetings are held at the following location:

Systems Documentation, Inc
1005 Slater Road, Suite 220
Durham, NC 27703.

Directions to Systems Documentation, Inc.

Communications

We have a Yahoo! Groups mailing list. To join, go to http://tech.groups.yahoo.com/group/rtp-dita/
For more information about the group, you also can contact keberlein at pobox.com.

Upcoming events

June 25, 2008: The DITA Troubleshooting Specialization

The DITA Troubleshooting Specialization (TSS) was released by IBM in 2007. Consistent, quality troubleshooting documentation is extremely important to customers and support costs. Come learn about the process the team went through to develop the architecture and specialization itself as well as how to use the specialization with the DITA Open Toolkit 1.4.

Presenters: Dan Dionne and Carolyn Inkster, IBM

July 23: Managing Content and Producing Output with the Eclipse IDE

An organization with limited resources must carefully choose its strategies for managing content and producing output. Since DITA is a dialect of xml, the available strategies are almost limitless. This variety is both a blessing and a curse. I will demonstrate the usage of a set of tools for managing content as well as generating output, using the Eclipse IDE. I hope to de-mystify some of the issues involved in storing and rendering content, and propose a solution that uses tools that are freely available.

One blessing of an open standard such as DITA is the freedom from being locked into a single set of content delivery tools. The set of tools I am about to demonstrate could be replaced, as a set or as single components, at any time, as new tools become available, without disrupting the integrity of your organization's data.

Presenter: Tom Ed White, Tekelec

Past events

January 23, 2008: Organizational meeting
February 27, 2008: Organizational meeting
March 26, 2008: Round table discussion on DITA maps and relationship tables

April 23, 2008: Using IBM Task Modeler to Create DITA-based Information Sets

IBM Task Modeler is a graphical tool that can be used to prototype and develop DITA-based information sets. Available as a free download from IBM Alphaworks, it generates graphical representations of DITA maps that can easily be understood by a wide range of stakeholders: managers, developers, marketing representatives, and technical communicators.

This session will provide an overview of the application and demonstrate how to use it to easily and rapidly create a DITA map, stub DITA files, and a relationship table that links the DITA files. Attendees also will receive a handout that augments the online help by explaining how to perform all of the tasks demonstrated.

Presenter: Kristen James Eberlein, Systems Documentation, Inc.

May 28, 2008: Brushing your teeth with DITA: Leveraging relationships to improve usability

After you have written your topics in DITA and created a table of contents with a DITA map, you can take your information architecture a step further and greatly improve the ability of your users to find the information they need by creating effective relationship tables. Using the simple documentation example of an information center on toothbrushing, we will demonstrate how to improve topic interlinking and usability by designing effective relationship tables which are easy for writers to implement.

We will cover the evolution of a relationship model which was developed for the IBM Director documentation, illustrating how changes to the model affect the relationship tables, and in turn, the inter-topic links in the information center. We will discuss the appropriateness of exceptions to the rule with the principle that usability for the customer trumps consistency. Examples will illustrate how application of the model -- and the judicious use of exceptions to the model -- improve the user experience.

Presenter: Shane Taylor, Computer Task Group