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.
Subject:Lousy vs. good writing, good vs. bad manuals From:"Gutierrez, Diane" <Diane -dot- Gutierrez -at- WESTGROUP -dot- COM> Date:Tue, 8 Dec 1998 17:13:54 -0600
The posting about manuals making sense in the original Japanese touched a
nerve with me. Let's get away from boring, three-pound, uninformative
manuals, and also from unhelpful, obscure and explanation-deficient
pamphlets that leave too many questions unanswered (and gives help numbers
that are disconnected or don't answer outside West Coast business hours).
Let's have friendly, chatty, background-information-giving,
differential-describing USER INFORMATION that is good for a relaxing read
before tangling with the hardware. The people who put out the "for dummies"
books have a good thing going. Minimalist stuff is fine, but nothing is
wrong with engaging, helpful information as well.