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
rgcombs AT gmailDOTcom

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.


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 for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at

Looking for the archived Techwr-l email discussions? Search our public email archives @


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