Archive - 2008

Audience and Task Analysis for DITA OT

The DITA OT user guide (authored by Dick Johnson and Anna van Raaphorst) is an excellent reference and has tons of useful information. It's one of the best references on the DITA OT. Sometimes, however, I feel that it's sheer size is a challenge for users, especially first-timers. We as a community need to help improve the existing DITA OT documentation by making it more user-friendly. Both Anna and Dick are busy and I have volunteered to reorganize the user guide and possibly break it down into smaller ones targeted by specific audience groups.

Read more

Self on Help

Parallel Documentation Universes

Until a few weeks ago, I was unaware that there was a company employing some 200 technical writers just two kilometres from where I teach technical communication in Melbourne, Australia.  Likewise, a manager at the company was unaware that my university provided post-graduate education in technical communication. We were operating in two parallel universes. The company involved operates in the "engineering technical publications" field, which seems to be quite separate (and isolated) from the "IT and corporate technical communication" field.

Read more

DITA Topic Specialization

Many great resources are available to
explain the mechanics and syntax of specializing the standard DITA DTDs
for your content—for example, Michael Priestley's Specializing topic types in DITA and Eliot Kimber's DITA specialization.
However, I didn't see any that walk readers through the process of
reviewing their existing content, evaluating its fit with the various
DITA topic types, and then designing and building a DITA specialization
around the needs and structure of their content, so I wrote the IBM
developerWorks tutorial DITA topic specializatio

Read more

DITA and Content Management with Steve Wiseman

Making the best decision for your documentation needs should be based on business considerations, not just the appeal of XML-based Content Management. XML is exciting; DITA is the hottest technique to use for Content Management, but is it really what you need in your documentation? Steve Wiseman of WritePoint took all of what Alex Masycheff said and turned it on its head.

Read more

The service orientation of … everything

...One interesting SOA trend that has emerged outside of the traditional application development domain is the service orientation of content—transforming monolithic documents into topic-oriented chunks that can be composed to create new documents and deliverables. DITA was conceived as a model for improving the reuse of content assets by turning them into well defined topic-oriented components.

Read more

XML.org Focus Areas: BPEL | DITA | ebXML | IDtrust | OpenDocument | SAML | UBL | UDDI
OASIS sites: OASIS | Cover Pages | XML.org | AMQP | CGM Open | eGov | Emergency | IDtrust | LegalXML | Open CSA | OSLC | WS-I