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.
> From: Jane Bergen [SMTP:janeber -at- CYBERRAMP -dot- NET]
<snip> How many people have you run
> into who, when you tell them you're a technical writer, laugh about
> "those computer manuals that no one can understand"? Those are the
> legacy of early tech writers who wrote mil specs or who understood
> the technology but failed as communicators. <snip>
>
I'm responding to Jane's post, but my comments are not directed
at Jane. The comment Jane made above I have heard over and over again
for years. Frankly, I think it's getting old. Today, when you hear
someone refer to "those computer manuals that no one can understand" it
is extremely unlikely that they are referring to the mainframe manuals
of yore. More likely, they are talking about manuals written within the
last five or six years. I think it is a cop out to continue to blame the
writer's of old computer manuals for comments being made today. (Unless,
perhaps, the comment came from someone who hasn't looked at a computer
manual for a dozen years.)