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: A NEW TOPIC (you can read this) From:Fred M Jacobson <boole!fred -at- UUNET -dot- UU -dot- NET> Date:Wed, 28 Apr 1993 16:40:50 PDT
> You don't say how your writing team fits in with the structure of the
> company. Are you in the same department as engineering, or are you in
> a different part of the heirarchy? ...
This and the attitudes it may represent are very important for your
satisfaction and effectiveness. If the engineers think they build the
product and then "throw it over the wall" to the tech writers and
marketing types, they don't know what a product is.
> Above all, don't trivialize your job -- the user manuals are as much a
> part of the product as the product itself.
Here the writer has unknowingly fallen into the trap! The software (or
whatever) is _not_ "the product itself." It's the software. If your
coworkers talk about the documentation _for_ the product, explain to them
that you are producing the documentation _of_ the product. Certainly
someone in your organization sees the bigger picture: If you have more
than a handful of users, better documentation reduces total costs by
reducing support costs. It also increases user satisfaction. Maybe you
can get someone with influence to attempt to engender this larger view
into the engineering group. You must adopt it yourself and try to understand
the contribution that the engineering, marketing, training, documentation,
support, and field staffs make to the success of your product and organization.
> nancy ott
-Fred Jacobson
Product Center Technical Writer
Boole & Babbage Network Systems
fred -at- boole -dot- com