Re: Perform vs. do

Subject: Re: Perform vs. do
From: Gene Kim-Eng <techwr -at- genek -dot- com>
To: Kathleen MacDowell <kathleen -dot- eamd -at- gmail -dot- com>
Date: Fri, 11 Oct 2013 20:13:11 -0700

I use the "cookbook analogy." Consider the layout of a recipe:

Name of Dish

Description of dish that makes it sound so yummy you want to make it.

List of ingredients.

Directions.

What's not there? "To cook (Name of Dish, which they already know from the title), do/perform the following steps:"

Could your readers follow a cookbook recipe that doesn't have that sentence? If so, why do they need it in a user manual?

Gene Kim-Eng


On 10/11/2013 6:57 PM, Kathleen MacDowell wrote:

Barbara, I've recently seen references to a "plain" language for technical
writing, but I can't remember where I saw it. I think it was on one of the
LinkedIn groups, but not the Plain Language one.



^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.

Learn more: http://bit.ly/ZeOZeQ

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

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-leave -at- lists -dot- techwr-l -dot- com


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

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


References:
Re: Agile Environment Opinions Wanted: From: Jen
Perform vs. do: From: Barbara Philbrick
Re: Perform vs. do: From: Milan Davidović
RE: Perform vs. do: From: Barb
RE: Perform vs. do: From: Barb
Re: Perform vs. do: From: Kathleen MacDowell

Previous by Author: Re: Perform vs. do
Next by Author: Re: Perform vs. do
Previous by Thread: Re: Perform vs. do
Next by Thread: Re: Perform vs. do


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

Sponsored Ads


Sponsored Ads