Diff for Research Triangle Park (RTP, NC) DITA users' group
Wed, 2008-06-25 20:55 by Kristen Eberlein | Thu, 2008-06-26 18:47 by Kristen Eberlein | ||
---|---|---|---|
< previous diff | next diff > | ||
Changes to Body | |||
Line 13 | Line 13 | ||
For more information about the group, you also can contact keberlein at pobox.com.
| For more information about the group, you also can contact keberlein at pobox.com.
| ||
<h2>Upcoming events</h2>
| <h2>Upcoming events</h2>
| ||
- | <p>
| ||
- | <br />
| ||
- | June 25, 2008: <strong>The DITA Troubleshooting Specialization</strong><br />
| ||
<br />
| <br />
| ||
- | 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.<br />
| ||
- | <br />
| ||
- | Presenters: Dan Dionne and Carolyn Inkster, IBM
| ||
- | </p>
| ||
<p>
| <p>
| ||
July 23: <strong>Managing Content and Producing Output with the Eclipse IDE</strong>
| July 23: <strong>Managing Content and Producing Output with the Eclipse IDE</strong>
| ||
Line 33 | Line 26 | ||
</p>
| </p>
| ||
<h2>Past events</h2>
| <h2>Past events</h2>
| ||
- | January 23, 2008: Organizational meeting<br />
| + | <p>
|
- | February 27, 2008: Organizational meeting<br />
| + |
|
- | March 26, 2008: Round table discussion on DITA maps and relationship tables<br />
| + | </p>
|
+ | <p>
| ||
+ | June 25, 2008: <strong>The DITA Troubleshooting Specialization</strong><br />
| ||
+ | 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.
| ||
+ | </p>
| ||
+ | <div align="center">
| ||
+ | Presenter: Carolyn Inkster, IBM
| ||
+ | </div>
| ||
+ | <div align="center">
| ||
+ | |||
+ | </div>
| ||
+ | <p>
| ||
+ | May 28, 2008: <strong>Brushing your teeth with DITA: Leveraging relationships to improve usability</strong><br />
| ||
+ | 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.<br />
| ||
+ | 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.
| ||
+ | </p>
| ||
+ | <div align="center">
| ||
+ | Presenter: Shane Taylor, Computer Task Group
| ||
+ | </div>
| ||
+ | <p>
| ||
<br />
| <br />
| ||
April 23, 2008: <strong>Using IBM Task Modeler to Create DITA-based Information Sets</strong><br />
| April 23, 2008: <strong>Using IBM Task Modeler to Create DITA-based Information Sets</strong><br />
| ||
+ | |||
+ | 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.<br />
| ||
+ | 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.
| ||
+ | </p>
| ||
+ | <div align="center">
| ||
+ | Presenter: Kristen James Eberlein, Systems Documentation, Inc.
| ||
+ | </div>
| ||
+ | <div align="center">
| ||
+ | |||
+ | </div>
| ||
+ | <p>
| ||
+ | March 26, 2008: Round table discussion on DITA maps and relationship tables
| ||
+ | </p>
| ||
+ | <p>
| ||
+ | February 27, 2008: Organizational meeting
| ||
+ | </p>
| ||
+ | <p>
| ||
+ | January 23, 2008: Organizational meeting<br />
| ||
<br />
| <br />
| ||
- | 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.<br />
| ||
<br />
| <br />
| ||
- | 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.<br />
| ||
<br />
| <br />
| ||
- | Presenter: Kristen James Eberlein, Systems Documentation, Inc.<br />
| ||
<br />
| <br />
| ||
- | May 28, 2008: <strong>Brushing your teeth with DITA: Leveraging relationships to improve usability</strong><br />
| ||
<br />
| <br />
| ||
- | 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.<br />
| + | </p>
|
- | <br />
| + | |
- | 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.<br />
| + | |
- | <br />
| + | |
- | Presenter: Shane Taylor, Computer Task Group<br />
| + | |
Research Triangle Park (RTP, NC) DITA users' group
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
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
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.
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.
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.
March 26, 2008: Round table discussion on DITA maps and relationship tables
February 27, 2008: Organizational meeting
January 23, 2008: Organizational meeting