Re: punctuating the end of bullet points

Subject: Re: punctuating the end of bullet points
From: Janice Gelb <janice -dot- gelb -at- sun -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Thu, 04 May 2006 10:55:43 +1000

Ron Hearn wrote:

The Sun Style Guide suggests

- End all sentence fragments with no punctuation

- End all sentences with appropriate punctuation

Um, actually that's not exactly what it says. The recommendations
in _Read Me First_ (the "Sun Style Guide") are a bit more nuanced:

For consistency, follow these guidelines when you
construct the items in lists:

* Capitalize the first word of each list item in all lists,
except for placeholders and other literal computer terms.

* Use punctuation at the end of each item in a list of
complete sentences.

* Use no punctuation at the end of each item in a list of
sentence fragments.

Avoid mixing complete sentences and sentence fragments in the
same list. If you must have a mixed list, add periods at the
end of every list item.

To make the list items parallel, a sentence in a mixed list
might be preceded by a fragment that describes or introduces
the sentence. The fragment ends with a period. The following
examples illustrate this recommendation.

Incorrect:
o Fragment
o Fragment
o This item is a complete sentence.
o Fragment

Better:
o Fragment.
o Fragment.
o This item is a complete sentence.
o Fragment.

Best:
o Fragment.
o Fragment.
o Fragment. This item is a complete sentence.
o Fragment.

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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!. http://www.webworks.com/techwr-l
Doc-To-Help includes a one-click RoboHelp project converter. It's that easy. Watch the demo at http://www.DocToHelp.com/TechwrlList

---
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 http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.


References:
RE: punctuating the end of bullet points: From: Ron Hearn

Previous by Author: Re: Readability - CD/web site
Next by Author: Re: Punctuating the end of bullet points?
Previous by Thread: Re: punctuating the end of bullet points
Next by Thread: RE: punctuating the end of bullet points


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


Sponsored Ads