Re: Andrew on engineers

Subject: Re: Andrew on engineers
From: Walter Crockett <walter -dot- crockett -at- informix -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 22 Nov 2000 09:02:26 -0600

Andrew really hit it on the head with this one. Absolutely correct. It bears

Andrew Plato wrote:
While some engineers are like this, honestly, most engineers do respect the
need for decent documentation. The problem is that many engineers feel like
writers have zero interest in really understanding what the engineers do.

Engineers LOVE to talk about their work and demonstrate their knowledge.
there is an entry fee to get this knowledge. You have to have *some*
capability and be able to talk shop with them. If you show with a "I don't
to know those technical things" attitude, of course they will think you're a
waste of time. You're not helping make their product look better.

If you can't or won't engage SMEs in a thoughtful technical conversation,
they aren't going to trust you to adequately communicate the design of their
system. Imagine if somebody walked up to you and said they were going to
a detailed user manual on FrameMaker, but had NO idea how to use the product
even what it could do (and had no intention of learning). Would you trust
person to write such a manual?

Develop HTML-based Help with Macromedia Dreamweaver! (STC Discount.)
**NEW DATE/LOCATION!** January 16-17, 2001, New York, NY. or 800-646-9989.

Sponsored by SOLUTIONS, Conferences and Seminars for Communicators
Publications Management Clinic, TECH*COMM 2001 Conference, and more or 800-448-4230

You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit for more resources and info.

Previous by Author: FrameMaker bug in Windows: Rotating large graphics or anchored fr ames results in truncation
Next by Author: Voice Recognition Software
Previous by Thread: Re: Style Guide for Functional/Technical Specifcations
Next by Thread: OT: How those new corporate names are created

What this post helpful? Share it with friends and colleagues:

Sponsored Ads

Sponsored Ads