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.
> You can't write a manual that's better than the product.
Sorry, Wayne, but I beg to differ...
I've documented some pretty awful (consumer) hardware and software -- in
environments where the developers constantly stressed:
"Those are NOT bugs, they're features!"
"Works as designed!!!"
Yet a good documentation team:
* can make a difficult product easy to install and use
* can recommend troubleshooting fixes for when the hardware/
software doesn't do things as you'd expect it should
* 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 was the manager of a doc department. As they say,
"Been there...done that!"