RE: Is there a better way to word this?

Subject: RE: Is there a better way to word this?
From: "Combs, Richard" <richard -dot- combs -at- Polycom -dot- com>
To: "Borowik, Kristy" <Kristy_Borowik -at- lcca -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 10 Jun 2009 15:08:45 -0600

Borowik, Kristy wrote:

> I really hate it when manuals say something like: "Click the x link,
> you will be returned to the x page." It's the "and you will be
returned to"
> part that bothers me, or when people say "Click this link and you will
> taken to (whatever)." Is there a better way to say that? After all,
> users never leave their seats! :)
> I was thinking maybe something like: "The x page reappears." Any other
> suggestions?

"To return to the x page, click the x link." Better yet, just "click x"
unless x by itself is ambiguous in this context and you need to
explicitly specify "the ... link."

But returning to the x page may not be the real goal. In that case,
something like, "To framboozle the x-pods, click x. The x page appears.
Select a framboozle level..."

There's really no need to use "reappears" instead of "appears" (and
displays/redisplays is just plain wrong, as Suzette Leeming pointed


Richard G. Combs
Senior Technical Writer
Polycom, Inc.
richardDOTcombs AT polycomDOTcom
rgcombs AT gmailDOTcom


ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
HTML and publish to the Web, Help systems or printed manuals.

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!

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

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

Please move off-topic discussions to the Chat list, at:

Is there a better way to word this?: From: Borowik, Kristy

Previous by Author: RE: Post-interview: "We'll call you"
Next by Author: RE: Post-interview: "We'll call you"
Previous by Thread: RE: Is there a better way to word this?
Next by Thread: STC suggestions on Twitter

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

Sponsored Ads