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.
Re: The Positron and Electron of Technical Writing
Subject:Re: The Positron and Electron of Technical Writing From:"Marie C. Paretti" <mparetti -at- RRINC -dot- COM> Date:Tue, 8 Dec 1998 14:29:40 -0500
At 09:22 AM 12/8/98 -0800, Thomas Quine wrote:
>If you take good technical writing and break it down to its essential
>components, at the molecular level it consists of only two things:
>
>1. Instructions on how to perform a task, and
>2. Units of knowledge which are a prerequisite to carrying out those
>instructions.
Actually, I'd say that's only true for one segment of technical writing -
the one concerned with writing instructions. What about writers who prepare
annual reports for a company, or who create informational brochures, data
sheets, product specifications, medical pamphlets, and a whole raft of
other non-instructional data? When I am reading a brochure that explains,
in terms I can understand, exactly what rolfing is (deep muscle tissue
manipulation, if you're interested), I'm not looking for instructions on
how to do it; I'm simply trying to understand what this person is about to
do to my body. The technical documentation is not a prerequisite for
anything except maybe my peace of mind.
Technical writing is, as we've all said, an extremely broad field that
reaches far beyond instructional documentation.
Marie
Marie C. Paretti, PhD
Recognition Research, Inc. (RRI)
1750 Kraft Drive, Suite 2000
Blacksburg, VA 24060
mparetti -at- rrinc -dot- com http://www.rrinc.com