From STC 2005
Many resources are available to explain what Darwin Information Typing
Architecture (DITA) topic specialization is and the syntax to implement
it, but you still might be wondering "I have some content that might be a
candidate for topic specialization. What's next?" This tutorial
walks you through a series of steps to evaluate your content's suitability
for different DITA topic types, specialize one of those types, and test
your specialization using the DITA Open Toolkit.
Lisa Dyer and Alan Porter presented at last week’s DITA Central Texas User Group meeting, and both told tales of end-user doc written and sourced in DITA, with wikitext in mind as an output. About 20 people attended and we all enjoyed the show. I wanted to post my notes to follow up, and I’ll post a link to slide shows as well.
This post covers Lisa Dyer’s presentation on a wiki sourced with DITA topics. I’ll write another post to cover Alan’s presentation.
What is a good short description for a task?
Some of the short descriptions indicated as "good" in the
class assignments simply restated information that was in the short description of the
related concept. The task's short description may have been written differently
and in the imperative, but it was redundant information.
