Re: Using capital letters

Subject: Re: Using capital letters
From: "Bergerson, Carl A" <Carl -dot- Bergerson -at- UNISYS -dot- COM>
Date: Fri, 8 Aug 1997 09:51:08 -0600

On every keyboard I've used for the last ten years or so it's Esc not ESC.

----------
From: Peter Brown[SMTP:pbrown -at- mks -dot- com]
Sent: Friday, August 08, 1997 8:27 AM
To: TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU
Subject: Re: Using capital letters

Jennifer O'Neill wrote:
> A tech writer who recently joined my company uses capital letters in
> a way I can't quite follow and am not very keen about. She just
> handed in a manual with sentences like:
>
> The Red LED on the Alarm Panel will be lit.
>
> or
>
> The Display scrolls through the options.
>
> When I asked her about it she said that these were key words.

What does "key words" mean?? Only proper nouns should be capitalized in
the middle of a sentence. A regular piece of jargon becomes a proper
noun if the product you're documenting uses it to name a specific object
or concept within that product.

"Press ESC to cancel the operation." Cancel is in lowercase.
"Click Cancel." Cancel is first-caps because it's the NAME of a button.

Now, if the Alarm Panel in your example above is the formal name of a
part of the product (evidenced by its first-capped appearance anywhere
on the surface of a physical object or in the user interface of a
software product), then the usage used above is correct. But "Red"? Not
likely.

In the case of software, I like to apply the simple rule of ensuring
consistency with the GUI (as long as the GUI is itself internally
consistent). That means, in most cases, that names of menus, commands,
dialog boxes, and buttons, settings, and fields inside of dialog boxes
are first-capped.

--
---------------------------------------------------------------
"Opinions? I've had a few. But then again, too few to mention."
Peter Brown, Technical Writer (pbrown -at- mks -dot- com)
Mortice Kern Systems Inc. (http://www.mks.com)

TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
to LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU (e.g. HELP or SIGNOFF TECHWR-L).
Search the archives at http://www.documentation.com/ or search and
browse the archives at http://listserv.okstate.edu/archives/techwr-l.html

TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
to LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU (e.g. HELP or SIGNOFF TECHWR-L).
Search the archives at http://www.documentation.com/ or search and
browse the archives at http://listserv.okstate.edu/archives/techwr-l.html


Previous by Author: Re: One or two spaces after a full stop?
Next by Author: Re: Choosing a menu option
Previous by Thread: Re: Using capital letters
Next by Thread: Re: Using capital letters


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


Sponsored Ads