RE: Using the conjunction OR in mutually exclusive options

Subject: RE: Using the conjunction OR in mutually exclusive options
From: "Combs, Richard" <richard -dot- combs -at- Polycom -dot- com>
To: Mark Baker <mbaker -at- analecta -dot- com>, 'Donna McManus' <donna -dot- mcmanus -at- gmail -dot- com>, "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 8 Sep 2011 13:50:38 -0700

Mark Baker wrote:

> My opinion is that you should never present more than one equivalent
> method
> of accomplishing something in a procedure. If someone is reading a
> step-by-step procedure it is because they want to get a specific task
> done.
> One method will suffice for this purpose; offering an alternative is
> just a
> distraction.
>
> A person who is sufficiently unfamiliar with the product to require
> instruction of this kind does not need the extra chore of choosing
> between
> two alternative, especially when there is no guidance provided on why
> to
> choose one option over the other. Make their life simpler: choose for
> them.
> If a person uses the application often, they will learn that there are
> alternate ways of doing things. If they don't use it often, they don't
> care
> that there are alternate ways of doing things.
>
> A good topic should do one thing. Putting alternative methods into a
> procedure is an attempt to teach the interface to a user who is just
> trying
> to get a job done. For users who want to learn the interface, write a
> topic
> on how the interface works.
>
> But if you absolutely must state the alternatives, the first form is
> both
> clearer and more conventional.

What he said. In large neon letters. With full orchestral accompaniment.


Richard G. Combs
Senior Technical Writer
Polycom, Inc.
richardDOTcombs AT polycomDOTcom
303-223-5111
------
rgcombs AT gmailDOTcom
303-903-6372
------






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

Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.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:
Using the conjunction OR in mutually exclusive options: From: Donna McManus
RE: Using the conjunction OR in mutually exclusive options: From: Mark Baker

Previous by Author: RE: Grammar - The Gotcha Microsoft Gives
Next by Author: RE: What's your CMS editing process?
Previous by Thread: RE: Using the conjunction OR in mutually exclusive options
Next by Thread: Re: Using the conjunction OR in mutually exclusive options


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


Sponsored Ads