Re: icons vs. buttons?

Subject: Re: icons vs. buttons?
From: Janice Gelb <Janice -dot- Gelb -at- Sun -dot- COM>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Thu, 02 Aug 2007 07:36:19 +1000

Keith Hansen wrote:
> Janice wrote:
> <<Click the OK button (indicated by a thumbs-up icon).>>
> Let's assume the button does NOT have a thumbs-up icon. It just has the
> letters "OK" on it.
> Is it necessary to say "Click the OK button"?
> Or is just "Click OK" acceptable?
> What is the consensus?

The rule in our style guide is:

If you are referring to a common button name (such
as OK) or have established a button name used in the
application, you can eliminate the surrounding phrase
“the ... button"

-- Janice

Janice Gelb | The only connection Sun has with
janice -dot- gelb -at- sun -dot- com | this message is the return address

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more.

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity!

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.

RE: icons vs. buttons?: From: Keith Hansen

Previous by Author: RE: Quote of the Day
Next by Author: Re: Multiple time zones
Previous by Thread: RE: icons vs. buttons?
Next by Thread: Re: icons vs. buttons?

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

Sponsored Ads