RE: Advocating Documentation and Support
> Reading the "Talkbacks" has also been enlightening,
> especially about the way that programmers and engineers feel
> about documentation:
> "When you buy a VCR, does the merchant stop and offer you a
> free lesson on how to program it?
No, but (again) the VCR doesn't "unexpectedly shutdown" making you restart
your television every so often.
And furthermore, a) a VCR is one of those things that you _need_ documentation for -- they're getting simpler, but there are still fancy functions that documentation is necessary for, and b) my VCR, at least, comes with a technical support number. Which I haven't needed, because the documentation is adequate.
In fact, when I explain to people what a technical writer does, I use "instructions for your VCR" as the example. People understand that it's comparatively complicated, and that there's value in explaining how to use it properly.
Beth Friedman / bjf -at- wavefront -dot- com
"The nice thing about standards is that there are so many of them to choose from."
-- Andrew Tanenbaum
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:
Next by Author: Health insurance for contractors
Previous by Thread: RE: Advocating Documentation and Support
Next by Thread: RE: Advocating Documentation and Support
Visit TechWhirl's Other Sites