Re: Narrative Technical Writing

Subject: Re: Narrative Technical Writing
From: Robert Lauriston <robert -at- lauriston -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Thu, 5 Nov 2009 11:03:00 -0800

Uh, make that "tolerances ... are a lot lower."

On Thu, Nov 5, 2009 at 10:18 AM, Robert Lauriston <robert -at- lauriston -dot- com> wrote:
> That's my informed opinion as a cook who has followed thousands of
> recipes, made hundreds of waffles, and been served many bad pancakes
> and waffles made by inexperienced cooks *following* good recipes.
>
> Leavened batters are fussy. The tolerances for the proportions of
> ingredients are a lot higher than with most dishes.
>
> On Thu, Nov 5, 2009 at 7:30 AM, Chris Despopoulos
> <despopoulos_chriss -at- yahoo -dot- com> wrote:
>> Are you saying you tried it and had to clean up a mess?  Or are you simply assuming that would be the case?
>>
>> Look, I really think the book is over the top in some ways.  But I also think it has an interesting approach.  I don't know if the book begins with a statement about user assumptions -- that might clear some issues up.  I do think that if you read the recipe reasonably and pay attention to what you're doing, you can end up with a decent waffle.  I'm sure I could, but I have to admit I haven't tried it either... No waffle iron in the house.
>>
>> # Wow, that's impressively awful. I can see the use for such a book in
>> # helping insecure cooks learn to improvise, but not providing even
>> # rough proportions means that a reader would likely have to clean up
>> # several messy failures before reaching a workable set of proportions
>> # through trial and error.
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Are you looking for one documentation tool that does it all? Author,
build, test, and publish your Help files with just one easy-to-use tool.
Try the latest Doc-To-Help 2009 v3 risk-free for 30-days at:
http://www.doctohelp.com/

Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


References:
Re: Narrative Technical Writing: From: Chris Despopoulos
Re: Narrative Technical Writing: From: Robert Lauriston

Previous by Author: Re: Transition that verb out of here!
Next by Author: Re: Doc Design and Convention - to address Gene's take on this
Previous by Thread: Re: Narrative Technical Writing
Next by Thread: Re: Doc Design and Convention ( was TECHWR-L Digest, Vol 48, Issue 27)


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


Sponsored Ads