RE: These users have us stumped!

Subject: RE: These users have us stumped!
From: "Marguerite Krupp" <mkrupp -at- cisco -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 23 Oct 2002 14:58:10 -0400

Why reinvent the wheel? Just give them something like the _Visual Quick
Start Guide for Windows_, which starts at the beginning, have your
instructors spend one session on basic skills, then start with your own
company's product in the second session.

It's not that you need to "dumb down" the docs any more than you have, but
you do need to build some basic skills. And if these people have learned how
to drive a car, they've learned how to operate something far more complex
than a computer running Windows. Somebody showed them how. So you need to
have your instructors do the same thing.

One thing that much of the entry-level product doc I've seen omits is the
reason WHY you would do something (or not do something). Lots of great
procedures, but no connection to doing something useful. Rather than
"dumbing down" docs, make the docs smarter in regard to the users' needs.

Or maybe my understanding of what you're asking is all wrong. It's been one
of those days.


All-new RoboHelp X3 is now shipping! Get single sourcing, print-quality
documentation, conditional text and much more, in the most monumental
release ever. Save $100! Order online at

Buy ComponentOne Doc-To-Help 6.0, the most powerful SINGLE SOURCE HELP
AUTHORING TOOL for MS Word. SAVE $100 on the full version and $50 on the
upgrade. Offer ends 10/31/2002 (code: DTH102250).

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 for more resources and info.

Re: These users have us stumped!: From: Paul Strasser

Previous by Author: RE: Resume citation for ex-companies
Next by Author: RE: Legal Requirments for a User's Manual
Previous by Thread: Re: These users have us stumped!
Next by Thread: Re: These users have us stumped!

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

Sponsored Ads