SUMMARY: teaching technical writing to engineers

Subject: SUMMARY: teaching technical writing to engineers
From: Evelyn G Barker <ebarker -at- uta -dot- edu>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 29 Mar 2004 09:31:08 -0600


Thanks to everyone for all the great responses.

Evelyn

Summary of ideas for teaching technical writing to engineers

Types of items to create

Specifications
White papers
Proposals
Requirements
Status reports
Email
Test assertions
Design docs
Process docs
End-user manuals
Technical reports

Class project suggestions

Take a hot gadget like an MP3 player and write about it:
* End-user procedures (how to operate, upload songs, delete songs,
etc.)
* White papers on the technology
* Comparative analysis of different models
* Proposals to supply entire class with the gadget
Write processed of everyday activities:
* Making ice with an ice tray
* Sharpening a pencil
* Vacuuming the floor
* Raking the yard
Engage in role playing exercises as writer and SME or writer and end user.
Take existing instructions or memo that is unclear and have students rewrite
to that it is clear.
Bring manuals from home and discuss the good and bad features of each.
Have feedback/review sessions of their work.
Exercise to show how hard it is to write clear instructions:
Have two people, one with a drawing. The one with the drawing must explain
to the other how to draw the image without showing the drawing or making
gestures. The one with the drawing cannot look at the one doing the drawing
to see how they are doing.
Keep a journal
Paper prototyping exercise
Oral presentations

Books Recommended

Style - Toward Clarity and Grace by Joseph M. Williams
Strunk and White
Books by Alan Cooper
The Little, Brown Handbook
"User Interface Design for Programmers" by Joel Spolsky
Effective Writing: for Engineers, Managers, Scientists by HJ Tichy
' How to Write and Present Technical Information' by Charles H. Sides
Complete Idiot's Guide to Technical Writing by Krista Van Laan

University Programs Mentioned

Concordia
Northeastern
Cal Poly San Luis
Michigan Technological University

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

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.



Previous by Author: teaching technical writing to engineers
Next by Author: making pdf-files with bookmarks
Previous by Thread: Re: management creditability
Next by Thread: RE: SUMMARY: teaching technical writing to engineers


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


Sponsored Ads