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: Not Wanted--Technical Writers From:Beth Agnew <bagnew -at- INSYSTEMS -dot- COM> Date:Tue, 16 Dec 1997 12:43:02 -0500
Chris Hamilton wrote:
> I challenge anyone without substantial technical experience to document
> our product (a multi-tiered distributed application server) without
> going way past deadline or irritating the hell out of the developers
> trying to meet _their_ deadlines.
Yeah, let's see those poets tackle an API manual or explain client/server
computing in 25 words or less. :-)
Also, Nora Merhar, who has expertise in the Automated Call Distribution
arena, noted that the two explanations in Example 1 in that Washington Post
article convey different information. That holds true for Example 2 as
well. Too bad the writer of the Post article couldn't pick that up. Of
course, not being a technical writer ...
If we can extrapolate from the examples in the article, what that company
does is reposition information. They're adapting technical material for a
non-technical audience (sales/marketing). As we know, that's quite
different from writing for a technical audience. Both types of writing are
necessary, but I wish the article had made them sound less mutually
Senior Technical Writer, InSystems Technologies Inc.
65 Allstate Parkway, Suite 100 Tel: (905) 513-1400 ext. 280
Markham, Ontario, Canada L3R 9X1 Fax: (905) 513-1419 mailto:bagnew -at- insystems -dot- com Visit us at: http://www.insystems.com