Re: Advocating Documentation and Support

Subject: Re: Advocating Documentation and Support
From: Christine -dot- Anameier -at- seagate -dot- com
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Thu, 8 Mar 2001 12:13:27 -0600


Jeff Hanvey quoted a few programmers' and engineers' comments on
documentation...

<< "When you buy a car, does the dealer throw in a week's refresher course
on how to use the car's new features?" >>

No, but the dealer gives you an owner's manual.

<< "When you buy a VCR, does the merchant stop and offer you a free lesson
on how to program it?" >>

No, but the manufacturer includes an owner's manual.

Analytical types like programmers and engineers should know better than to
play this kind of linguistic shell game. To imply that we're coddling users
by providing documentation, they're making specious analogies to *personal
training sessions* as if the resources involved were equivalent.

Christine



^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Develop HTML-Based Help with Macromedia Dreamweaver 4 ($100 STC Discount)
**New Dates!!** San Francisco (Apr 16-17), San Jose (Mar 29-30)
http://www.weisner.com/training/dreamweaver_help.htm or 800-646-9989.

IPCC 01, the IEEE International Professional Communication Conference,
October 24-27, 2001 at historic La Fonda in Santa Fe, New Mexico, USA.
CALL FOR PAPERS OPEN UNTIL MARCH 15. http://ieeepcs.org/2001/

---
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.


Previous by Author: Re: Advocating Documentation and Support
Next by Author: Re: Technical Writing, QA, and Training
Previous by Thread: RE: Advocating Documentation and Support
Next by Thread: Re: Advocating Documentation and Support


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


Sponsored Ads