TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
>Sorry, Wayne, but I beg to differ...
>
>Yet a good documentation team:
> * can make a difficult product easy to install and use
If the installation procedure sucks, your manual will map it exactly. I
remember getting a reader response card from the field complaining that the
installation procedure in the manual was too complicated. It was - but that
was how you installed the product.
> * can recommend troubleshooting fixes for when the hardware/
> software doesn't do things as you'd expect it should
And it will look like the kludge that it is.
> * can present it in a clear, concise, user-friendly manner
> (with screen shots, bullet/number lists, and a comprehensive
> TOC and Index) so that end-users don't realize that the product
> is nearly as bad as it really is.
I give end-users more credit than you do.
>I was the manager of a doc department. As they say,
> "Been there...done that!"
>
So have I.
--Wayne
---------------------------------------------
Wayne Douglass phone: 408-542-2139
Verity, Inc. FAX: 408-542-2040
894 Ross Road mailto:wayned -at- verity -dot- com
Sunnyvale, CA 94089 http://www.verity.com
---------------------------------------------
