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

August 27: DITA 1.2: Understanding the upcoming release

DITA is still evolving. The OASIS Technical Committee responsible for the
standard is actively working on a draft of the next DITA release, which
will include significantly more features than the previous (1.1) release.
Come learn about plans for the release, what will be coming, and when. We
will go into depth on many of the new features, explaining where they came
from and how they will be used. We will also get a preview of several of
the new features using the latest test build of the DITA Open Toolkit, and
hear about what toolkit developers will be working on in the near future.

Presenter: Robert D. Anderson, IBM. Chief architect of the DITA Open Toolkit.

Past events

July 23:

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.

Presenter: Carolyn Inkster, IBM

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

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.

March 26, 2008: Round table discussion on DITA maps and relationship tables

February 27, 2008: Organizational meeting

January 23, 2008: Organizational meeting