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: I'd rather teach an engin... From:Ron Miller <RSMH -at- AOL -dot- COM> Date:Tue, 25 Apr 1995 20:13:44 -0400
I thought my little maxim was just a harmless bit of fluff, but it certainly
has ruffled some feathers out there.
When I said,
I once heard a saying that it's easier to teach a good writer how to be
>>technical than it is to teach a technical person who lacks writing skills
>>be a good writer.
I was certainly not trying to slight technical folks, I was merely trying to
make a point that those of us who were trained as journalists could make a
smooth transition into technical writing.
Though, I still maintain, if you look at manuals that have been written by
the developers, they are often poorly written and poorly organized, but even
in cases where the writing is coherent, the technical person often assumes
that the audience has the same level knowlede as he/she does. They
consequently write way over the head of the audience, rendering the manual
virtually incomprehensible. I realize there are exceptions to this rule, and
that it is a generalization, but if there weren't some truth to it, we
wouldn't have jobs; the manuals would be written by the engineers.