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: The Covert Interview From:Mike Christie <mikec -at- LUNA -dot- SYNTEL -dot- COM> Date:Fri, 6 Jan 1995 09:02:54 -0800
> And, of course, my worst nightmare is when the developer is reviewing my
> document and, while explaining how something works, says "'The discombobulator
> regurgitates the part of the prefix to some other portion of disk space.'
> That's the perfect sentence for this explanation. Write it just like that."
> That's when I'd like to say "I'll leave the code to you if you leave the
> text to me."
I was in a meeting going over a new, fairly complicated, feature. At the
end of the meeting the manager looked at me and said, "You'll put it in
the manual just as it appears in her spec, right?" The developer muttered
something to the effect of "I hope not!"
By the time I was done reworking the spec into a form suitable for
customer consumption everyone seemed happy with the result. (And I'm sure
the developer was pleased that I didn't keep her spelling errors,
awkward sentence structure, and poorly organized paragraphs.)
Syntelligence Systems, Inc.
mikec -at- syntel -dot- com