Last week at the WritersUA Conference in Portland, I chaired a "Developing Help with DITA" forum alongside Alan Houser, Matthew Ellison and Scott Prentice (all on the DITA Help Sub Committee). There was a lot of interest from delegates (the majority of whom are Help authors) in using DITA, although most are only 'testing the water'.

Read more

The Dita Open Toolkit offers an actively maintained output for Eclipse Help. One of the features of this help system is that it can be deployed as a stand alone help server.

Read more

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

"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?

Read more

In earlier musings about full-text search, I wondered whether the lack of full-text search (FTS) in the standard DITA OT XHTML outputs was restrictive. Bob Doyle pointed out that Eclipse Help InfoCenters provide FTS, and that led to some further wonderings about the complexity of Eclipse Help installations. I've since noticed some DITA users have come up with some ingenius workarounds so that DITA content can be turned into beautiful "WebHelp" output just like that produced by HTML-based Help Authoring Tools.

Read more