RE: tech writers cooking up the recipes...

Subject: RE: tech writers cooking up the recipes...
From: jgarison -at- ide -dot- com
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 30 Dec 2002 09:55:12 -0500


When I taught tech writing, one of the in-class exercises was to create a
well-organized result from a jumble of input (not like that ever happens in
the real world!).

The jumbled up input was a letter from Grandma who is explaining how she
makes her famous spaghetti sauce. The result, of course, is a recipe - well
organized and easy to follow.

Students loved it and said it finally made it clear to them what the job of
organization was all about.

John G

>>-----Original Message-----
>>From: Kat Nagel, MasterWork Consulting

>>Long before I started calling myself a technical writer, I used a set
>>of well-written vs. poorly-written recipes for the same dishes to
>>illustrate a brief training session for new technicians on how to
>>write up experiments in their lab notebooks. From then on, I've had
>>a recurring dream about a Neanderthal elder using cave paintings to
>>teach young initiates how to prepare a ritual dinner: "First, catch
>>something that looks like this...."

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Check out SnagIt - The Screen Capture Standard!
Download a free 30-day trial from http://www.techsmith.com/rdr/txt/twr
Find out what all the other tech writers, including Dan, already know!

Order RoboHelp X3 in December and receive $100 mail in rebate, FREE WebHelp
Merge Module and the new RoboPDF - add powerful PDF output functionality
to RoboHelp X3. Order online today at http://www.ehelp.com/techwr-l

---
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: RE: On recipe translation
Next by Author: RE: Online or print for SDK material?
Previous by Thread: Re: tech writers cooking up the recipes...
Next by Thread: translating recipes


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


Sponsored Ads