Re: Best New Thing in User Documentation?

Subject: Re: Best New Thing in User Documentation?
From: "Gene Kim-Eng" <techwr -at- genek -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 14 Jun 2011 14:54:11 +0100

The question was what's the best new thing in the past five years, not how good it is. Consider my answer a commentary on the relative "goodness" of recent new things.

My recent stint in consumer electronics was the first time in many years that I had written procedures that told the reader to click on things like "OK," and yes, for those readers it was needed. My usual "task oriented" procedure consists of walking the reader through the chain of configuration screens required to accomplish a goal and which settings need to be entered in each screen for the task at hand, because the systems have many potential configurations that use the same screens in different ways.

The "social media" our customers use to reach us is the telephone. A marvelous innovation that many young people today seem not to be aware of is that you can actually use it to talk to people.

Gene Kim-Eng

----- Original Message ----- From: "Phil Stokes" <philstokes03 -at- googlemail -dot- com>
I have a lot of sympathy with Chris's point of view, though I'd like to offer a few caveats.


Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.

Please move off-topic discussions to the Chat list, at:


Re: Best New Thing in User Documentation?: From: Chris Despopoulos
Re: Best New Thing in User Documentation?: From: Phil Stokes

Previous by Author: Re: Name of "receptacle" on back of hard ware that...
Next by Author: Re: localizing gerunds? (was: Writing English for Translation)
Previous by Thread: Re: Best New Thing in User Documentation?
Next by Thread: RE: Best New Thing in User Documentation?

What this post helpful? Share it with friends and colleagues:

Sponsored Ads