RE: Is there a better way to word this?

Subject: RE: Is there a better way to word this?
From: <Brian -dot- Henderson -at- mitchell1 -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 10 Jun 2009 13:53:50 -0700

Unless the particular document is intimately concerned with the actual
mechanics of browser information shuffling, I would suggest leaving
individual annoyance with conventional surfing lingo out of the picture.
Although, as tech writers we're here communicate a bit more precisely
than the unwashed masses, I think in the particular case of hyperlink
usage the actual experience is so much like being transported TO
somewhere and being RETURNED from there that not using common vernacular
would be mostly jarring. And some might think you're trying to say,
"Even though you've forgotten, I'm here to remind you as to what's
really going on".

-Brian H.

-----Original Message----- From: Borowik, Kristy

I really hate it when manuals say something like: "Click the x link, and
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 be taken to (whatever)." Is there a better way to say that? After
all, the users never leave their seats! :)

I was thinking maybe something like: "The x page reappears." Any other

Kristy Borowik


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: Tech Writing for Social Networks (Twitter, Facebook, etc.)
Next by Author: RE: The Tech Writer as Smuggler
Previous by Thread: Re: Is there a better way to word this?
Next by Thread: Re: Is there a better way to word this?

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

Sponsored Ads