Re: Managing Engineers

Subject: Re: Managing Engineers
From: Andrew Plato <intrepid_es -at- yahoo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 21 Nov 2000 09:59:52 -0800 (PST)

"Hyde, Barb wrote
>
> Heck, Andrew, they aren't even going to come to you and say, "Here is our
> software, please document it for us."
>
> One thing your correspondent should be aware of is that the attitude is not
> there because the documenter is a contractor. It is there because engineers
> are engineers and they don't need no stinking documentation (to paraphrase a
> movie line.)

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

Engineers LOVE to talk about their work and demonstrate their knowledge. But,
there is an entry fee to get this knowledge. You have to have *some* technical
capability and be able to talk shop with them. If you show with a "I don't need
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, then
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 write
a detailed user manual on FrameMaker, but had NO idea how to use the product or
even what it could do (and had no intention of learning). Would you trust this
person to write such a manual?

Andrew Plato

__________________________________________________
Do You Yahoo!?
Yahoo! Shopping - Thousands of Stores. Millions of Products.
http://shopping.yahoo.com/

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Develop HTML-based Help with Macromedia Dreamweaver! (STC Discount.)
**NEW DATE/LOCATION!** January 16-17, 2001, New York, NY.
http://www.weisner.com/training/dreamweaver_help.htm or 800-646-9989.

Sponsored by SOLUTIONS, Conferences and Seminars for Communicators
Publications Management Clinic, TECH*COMM 2001 Conference, and more
http://www.SolutionsEvents.com 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
http://www.raycomm.com/techwhirl/ for more resources and info.


Previous by Author: Managing Engineers
Next by Author: Re: Managing Engineers
Previous by Thread: Re: Managing Engineers
Next by Thread: RE: Managing Engineers


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


Sponsored Ads