RE: Click X, or click the X button?

Subject: RE: Click X, or click the X button?
From: "Claudine CHAUSSON" <claudine -dot- chausson -at- jwaretechnologies -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 23 Oct 2009 09:36:59 +0200

I use: Click XYZ. The UI I'm documenting mostly uses links to trigger
actions. Each link is made of a small icon followed by the name of the
action. Since the UI is not, in my eyes, very user-friendly, I try to guide
my users with a screen capture of the icon followed by the name of the
command. So far, I haven't had any comments on that since my first doc for
that company is due next week. I hope the final customer finds it useful!

Also, as I write in English and since English is not my first language (nor
my customer's), I find "Click XYZ" easier to understand (and to translate?)
for an international audience. But maybe I'm wrong.


Technical writer
JWARE Technologies

Please consider the environment before printing this email.


Free Software Documentation Project Web Cast: Covers developing Table of
Contents, Context IDs, and Index, as well as Doc-To-Help
2009 tips, tricks, and best practices.

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:


Previous by Author: Re: Export controls (was RE: Documentation confidentiality level
Next by Author: RE: Landscape vs. Portrait
Previous by Thread: Re: Click X, or click the X button?
Next by Thread: RE: Click X, or click the X button?

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

Sponsored Ads