Re: Capitalization in lists

Subject: Re: Capitalization in lists
From: Janice Gelb <Janice -dot- Gelb -at- Sun -dot- COM>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Thu, 28 Jan 2010 07:04:04 +1100

On Jan 28, 2010 3:55AM, Deborah Hemstreet wrote:
> Hi All,
> Is there a definitive methodology for capitalizing the first word in lists?
> For example,
> This is used to
> 1. eat a cat
> 2. kill a mouse, or
> 3. ride a horse.
> vs
> This is used for:
> 1. eating cats.
> 2. killing mice.
> 3. riding horses.
> vs.
> Use this to:
> 1. Eat a cat
> 2. Kill a mouse
> 3. Ride a horse
> -------------------------------
> Are all of the above correct? My mind has gone blank....

As others have said, this is largely a matter
of style. However, I do want to mention in case
your docs are translated that our localization
people have told us not to break infinitives
across a list introduction because many languages
do not use that construct and it can therefore
cause difficulties.Therefore, they prefer
something like:

Use this feature for the following actions:
* Eating cats
* Killing mice
* Riding horses


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


Are you looking for one documentation tool that does it all? Author,
build, test, and publish your Help files with just one easy-to-use tool.
Try the latest Doc-To-Help 2009 v3 risk-free for 30-days at:

Explore CAREER options and paths related to Technical Writing,
learn to create SOFTWARE REQUIREMENTS documents, and
get tips on FUNCTIONAL SPECIFICATION best practices. Free at:

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:


RE: A classic warning sign...: From: Monique Semp
Fonts for translation: From: Chinell, David F (GE EntSol, Security)
Capitalization in lists: From: Deborah Hemstreet

Previous by Author: Stop Sign Design
Next by Author: Re: Capitalization in lists
Previous by Thread: RE: Capitalization in lists
Next by Thread: Re: Capitalization in lists

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

Sponsored Ads