RE: teaching technical writing to engineers

Subject: RE: teaching technical writing to engineers
From: "walden miller" <wmiller -at- vidiom -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 24 Mar 2004 12:02:11 -0700




I would strongly recommend teaching engineering writing to engineers.

That is use writing tasks that are applicable to tasks engineers are most
likely to be asked to do:

Specifications
White papers
Proposals
Requirements
Status
Email
Documenting UML diagrams
Test assertions
API design docs
Hw design docs
Process docs

I would also want to teach the relationship between designing and testing
and documenting.

Many of the responses so far have been essentially trying to get the
engineer to work with writers better. That is nice. It doesn't necessarily
help the engineer with her job. Better communication skills and better
writing skills for their job will help them. As a side effect, it will make
a tech writers job easier as well.

Having a great source document and an engineer that understands the rigor
that a great source document requires will be a major plus in any
engineering process.

walden


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

ROBOHELP X5 - ALL NEW VERSION. Now with Word 2003 support, Content
Management, Multi-Author support, PDF and XML support and much more!

Now is the best time to buy - special end of month promos, including:
$100 mail-in rebate; Free online orientation on content management
functionality; Huge savings on support and future product releases;
PLUS Great discounts on RoboHelp training. OFFER EXPIRES March 31!
Call 1-800-358-9370 or visit: http://www.ehelp.com/techwr-l

---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -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.



References:
teaching technical writing to engineers: From: Evelyn G Barker

Previous by Author: RE: Quiet workplace
Next by Author: RE: would versus will
Previous by Thread: Re: teaching technical writing to engineers
Next by Thread: Re: teaching technical writing to engineers


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


Sponsored Ads