Re: Style question about quotes

Subject: Re: Style question about quotes
From: "Kevin Amery" <kevindamery -at- gmail -dot- com>
Date: Tue, 28 Nov 2006 09:26:33 -0500

On 11/27/06, Janice Gelb <janice -dot- gelb -at- sun -dot- com> wrote:

Our internal style does not use quotes. We use initial capitals,
not bolded.

There are several reasons why we do not format GUI items
with bold or other special formatting:

* In procedures that are performed in a GUI, every step
would contain probably at least a couple of items with the
special formatting, so picking out GUI items from regular
text would not really be all that easy. Plus the procedures
start looking like ransom notes.

* We want users to read the explanatory text between menu
item and button names. We don't just want them randomly
clicking and choosing things that are in bold or some other

-- Janice

At my former employer, we had a character style for UI elements that
used a different font. the idea was to make it easier for customers to
recognize what they should look for on the screen.

Until next time...

Kevin Amery
Tech Writer in Toronto

WebWorks ePublisher Pro for Word features support for every major Help format plus PDF, HTML and more. Flexible, precise, and efficient content delivery. Try it today!

Easily create HTML or Microsoft Word content and convert to any popular Help file format or printed documentation. Learn more at

You are currently subscribed to TECHWR-L as archive -at- infoinfocus -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: Style question about quotes: From: Beth Agnew
Re: Style question about quotes: From: Janice Gelb

Previous by Author: Re: Temp/permanent annotations?
Next by Author: Re: Compliance Documents for Daylight Savings
Previous by Thread: Re: Style question about quotes
Next by Thread: Re: Style question about quotes

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

Sponsored Ads