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.
"Airplane Help" describes a technique whereby locally installed Help and server-based Help are integrated, so that a software application user is presented with server Help if he or she has an Internet connection, or local Help if not. The advantage of this approach is that the most current version of the Help is displayed if possible, but at least some form of Help is displayed when the user is "offline". Can DITA play a role in delivering Airplane Help?
Materials:
Assignment:
The DITA Maturity Model divides DITA adoption into six levels, each with its own required investment and associated return on investment.
