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: Occupational hazard of techie tech writers From:Damien Braniff <Damien_Braniff -at- PAC -dot- CO -dot- UK> Date:Mon, 2 Nov 1998 09:05:13 +0000
As always, it's about writing for your audience. While I feel that not
being over-familiar with some subjects may help appreciate the user's point
of view it is assuming the user has as little knowledge as you do!! I've
also found that very techie writers are often writing for a "higher level"
end user. I've written stuff for general reading where the level of
understanding was low (e.g. management summaries where what was important,
not how) and I've written stuff for experienced engineers where you don't
have to everything - if they're using the lit you've produced they should
already be familiar with the terms used etc.