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.
Moshe described a situation where a manager insisted on expanding
an introduction into a theoretical tome. I have run into the same
thing. It seems to resolve around a cognitive flaw. Some people
feel uneasy when a statement in the introduction does not contain
the entire truth, and want to pour in a more complete description
and enumerate all the exceptions.
Thus, the page-one bullet item that introduces the feature that is
discussed in chapter 3 expands until is becomes a second copy of chapter 3.
At this point, the cognitively-impaired reviewer will worry that the
first paragraph of chapter 3 does not contain all the material in the
subsequent 37 pages.
There are several ways of dealing with such people. Killing them
is the most satisfying, but is hard on the carpets. Actively hiding
introductory material from them is better. Once they complain, simply
rip out the introductory material, leaving them with a big, fat,
technical first chapter. They will be happy. Have people whose
minds do not slag down when presented with introductory material review
the introductory material. Get some review comments to the effect that
introductory material is necessary, then slap it back in at the last
You can do this without being sneaky at all. Simply divide the
manual up into chunks, and give different chunks to different reviewers.
Few people will complain about having to review only the stuff that
they're particularly expert in.
Robert Plamondon, President/Managing Editor, High-Tech Technical Writing, Inc.
36475 Norton Creek Road * Blodgett * Oregon * 97326
robert -at- plamondon -dot- com * (541) 453-5841 * Fax: (541) 453-4139