RE: wording q - is "both" superfluous?

Subject: RE: wording q - is "both" superfluous?
From: "Combs, Richard" <richard -dot- combs -at- Polycom -dot- com>
To: Monique Semp <monique -dot- semp -at- earthlink -dot- net>, TechWR-L <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Mon, 23 Jul 2012 09:53:51 -0700

Monique Semp wrote:

> So in the doc I want to say that âYou can <access the function screen>
> from two starting points in the menu:â, then give the bullet list of
> the two menu paths, and then I want to explain that they bring you to
> the same screen.
>
> So for that final sentence, which of the following is best, and, more
> importantly, why?
>
> * Both menu selections bring you to the <function> screen.
> * Either menu selection brings you to the <function> screen.

You start by telling them to access the <function> screen in one of two ways and end by telling them those are the two ways to access the <function> screen. Too many words. Too much repetition and detail. That's how you end up with a thousand-page manual that nobody ever reads.

> Or, maybe I avoid it altogether and just say, âWhen you choose the
> <function> from the Dashboard menu, the <function> screen appears.â

Much better.

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://bit.ly/doc-to-help

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

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


Follow-Ups:

References:
wording q - is "both" superfluous?: From: Monique Semp

Previous by Author: RE: NLA (no longer an acronym)?
Next by Author: RE: Global Access to FrameMaker Source Files
Previous by Thread: wording q - is "both" superfluous?
Next by Thread: RE: wording q - is "both" superfluous?


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

Sponsored Ads


Sponsored Ads