RE: Quotation marks around user interface labels

Subject: RE: Quotation marks around user interface labels
From: "McLauchlan, Kevin" <Kevin -dot- McLauchlan -at- safenet-inc -dot- com>
To: "Robart, Kay" <Kay -dot- Robart -at- tea -dot- state -dot- tx -dot- us>, Nancy Allison <maker -at- verizon -dot- net>, "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 19 Jul 2011 10:56:36 -0400

> -----Original Message-----
> From: Robart, Kay
> I never use quotation marks for things like this.
> It depends upon what elements of the interface are being described. The
> Microsoft Style Guide calls for menu commands, buttons, and dialog box
> elements to be bolded but for window names to not be, and that's what
> I've been following for years. In fact, I was doing that for years
> before then, because I started on UNIX computers and we followed the
> Sun
> style guide, which had the same rule. However, you should follow
> whatever style your organization has determined, and if it doesn't have
> a style guide, it might be a good time to start making decisions like
> this with the other writers in your organization, if there are any, and
> writing those decisions down.

Some of us have learned to avoid bolding as an identifier because
we produce WebHelp, and for some years the bold attribute was
considered unreliable in webbish contexts - browsers could treat it
differently, it was overtaken by <strong> </strong>, which could
sometimes be rendered as italic, rather than bold, etc.

Fortunately (?) we still provide a command-line interface to
the software side of our products, so for single keys and buttons,
my "standard" has been to surround the item in square brackets
like [ OK ] or [ Yes ], [ No ], [ Enter ], [ < ] and [ > ].

For other stuff - and for the GUI we'll eventually have - I
also like Janice's approach.

- kevin

The information contained in this electronic mail transmission
may be privileged and confidential, and therefore, protected
from disclosure. If you have received this communication in
error, please notify us immediately by replying to this
message and deleting it from your computer without copying
or disclosing it.


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-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:


Quotation marks around user interface labels: From: Nancy Allison
RE: Quotation marks around user interface labels: From: Robart, Kay

Previous by Author: RE: Tips on how to talk to SMEs
Next by Author: RE: Modern vs Old-fashioned Help
Previous by Thread: RE: Quotation marks around user interface labels
Next by Thread: Re: Quotation marks around user interface labels

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

Sponsored Ads