RE: Reference Manual

Subject: RE: Reference Manual
From: "Gilger.John" <JGilger -at- acresgaming -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 30 Jan 2001 13:54:02 -0800

Steve Shepard queried:

> I'm a tech writer and I cook a lot. You would think a recipe in a cookbook
> and writing, say, software documentation would have some similarities.
> just as there is a fair amount of bad technical writing, cookbook recipes
> seem to be even worse.
> For example, beginning with a list of ingredients is great, but often they
> aren't in any order that makes sense. And if the prep and cooking
> instructions are numbered, they usually include several steps, not one at
> time. When the instructions are in prose, I find I often have to read the
> paragraph two or three times to figure out what I am actually supposed to
> do. And when I am told "do this, but not that" I am never told "why"
> it in a plastic or ceramic bowl, not glass).
> From the point of view of a tech writer, what would be a better way to
> present this kind of information.
> I am looking for ideas as I document (surprise) my recipes and I don't
> to fall into the same trap.

Writer's Digest has an
interesting book available called "You Can Write a Cookbook" that should
answer most of your questions.

John Gilger
Technical Writer
Acres Gaming, Inc.

Develop HTML-Based Help with Macromedia Dreamweaver 4 ($100 STC Discount)
**WEST COAST LOCATIONS** San Jose (Mar 1-2), San Francisco (Apr 16-17) or 800-646-9989.

Sponsored by DigiPub Solutions Corp, producers of PDF 2001
Conference East, June 4-5, Baltimore/Washington D.C. area. or toll-free 877/278-2131.

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: RE: Monitor shutting off
Next by Author: RE: Telecrastinating
Previous by Thread: Re: Reference Manual
Next by Thread: RE: Reference Manual

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

Sponsored Ads

Sponsored Ads