“Dubious Prospects” and DITA

Another blog site I’d like to point out to people interested in all things DITA is the one run by former work colleague of mine Graydon Saunders which he calls “Dubious Prospects“.

Though focused mainly on his recreational photographic pursuits, there are over a dozen great articles collected together here on various aspects of doing DITA.

Some of the information here is “dense”, requiring some thought to ensure you understand what’s actually being said before moving along to the next thing, but well worth it for the insights.

Where to start? Some suggestions:

  • Content Conversion Issues: an article whose premise is nicely summed up by the phrase: “it’s not supposed to look the same!”
  • Articles one and two dealing with Narrative authoring vs. topic based authoring and where productivity gains come out of doing the latter over the former
  • It’s Titles All the Way Down: points out that title elements are there for labelling purposes, not necessarily to provide structure

All worth taking a look at, and even if you don’t end up agreeing with all of his points (I didn’t on some of them, and said so in the comment sections of a couple of his pieces) they do provide food for thought.

About

"DITAWriter" is Keith Schengili-Roberts. I work for AMD as a Senior Manager for Technical Documentation, and have recently helped usher in a new company-wide DITA-based CCMS. And I like to write about DITA and the technical writing community. To get ahold of me you can email me at: keith@ditawriter.com.

View all posts by