RE: doc'ing the docs (was RE: Hackos' minimalism seminar -- some insights)

Subject: RE: doc'ing the docs (was RE: Hackos' minimalism seminar -- some insights)
From: "Marguerite Krupp" <mkrupp -at- cisco -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 2 Dec 2002 13:55:33 -0500


Jan henning wrote:
> I wonder about that. I certainly do not doubt your account or that it
> is typical. But are people who do not have the patience to closely look
> at the interface going to read documentation about documentation?
>
> My personal experience indicates otherwise. But maybe that is atypical?

.........................
Maybe, but it's an easy hole to plug, and if it heads off a support call,
it's worth it.

In one product for a major manufacturer, there were THREE different Help
buttons, each of which took you to a different place. Lousy design, yes, but
we had to write around it.

As with anything else, if you know WHERE to look, finding the answer is
obvious. If you don't (and some interfaces are not at all intuitive), it
really "helps" to have "Help on Help."

Marguerite


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Check out SnagIt - The Screen Capture Standard!
Download a free 30-day trial from http://www.techsmith.com/rdr/txt/twr
Find out what all the other tech writers, including Dan, already know!

Order RoboHelp X3 in December and receive $100 mail in rebate, FREE WebHelp
Merge Module and the new RoboPDF - add powerful PDF output functionality
to RoboHelp X3. Order online today at http://www.ehelp.com/techwr-l

---
You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.



References:
Re: doc'ing the docs (was RE: Hackos' minimalism seminar -- some insights): From: Jan Henning

Previous by Author: RE: Different editing techniques in documentation
Next by Author: FW: doc'ing the docs (was RE: Hackos' minimalism seminar -- some insights)
Previous by Thread: Re: doc'ing the docs (was RE: Hackos' minimalism seminar -- some insights)
Next by Thread: RE: doc'ing the docs


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


Sponsored Ads