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:Re: HELP From:Pat Madea <madea -at- MMSI -dot- COM> Date:Tue, 8 Aug 1995 11:18:01 MST
Elna Tymes writes of one particular way of getting source material
(which I have used) but fails to mention on of its hidden dangers <g> :
>There is also another way to get source material. I call it "writing by
>provocation." This is sometimes what you have to resort to when your
>source information is incomplete or inaccurate, and you can't get what
>you need any other way. In that case, I write a draft with
>clearly-labeled missing or inaccurate pieces, and indicate that I need
>help filling the holes or fixing the inaccuracies. Normally I get back a
>review copy with a satisfactory amount of red ink showing me the error of
>my ways - and including the missing or accurate information. 's OK - I'll
>take it any way I can get it.
The hidden danger is missing a small hole or leaving some verbiage in
a large document that I used merely as a textual placeholder. This
method for me has come close to producing some embarrassing passages
in my documents. In one document, I just typed "yabba dabba doo for
now...." and other nonsense as a placeholder for information that
needed to be provided to me by a subject matter expert (SME). It was
overlooked until just before press time when it was brought to my
attention. Whoops!
"Writing by provocation" does work, but you gotta watch those holes and
placeholders..... especially in large documents < g >