From: manoj joshi <[email protected]>:
>
> I have a doubt in the section "List Introduction Guidelines." Please explain
> me when we write the points in the list, is it necessary to make the complete
> sentences or we can include the phrases in the lists.
>
> Should we put the period at the end of every point in the list. Which
> punctuation should be used for the points in the list 'a comma or a semicolon
> or a period.'
>
Greetings! Your question is answered in the _Documentation
Style Guide for OpenSolaris_ on page 25, in the section
"Capitalizing and Punctuating Lists":
For consistency, follow these guidelines when you construct
the items in lists:
* Capitalize the first word of each entry in all lists.
* 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.
The section goes on to provide techniques for avoiding fragments.
I never noticed that the term "punctuation" isn't specific! However,
it means periods. (There's a hint in the explanatory paragraph under
the list.)
Hope this is helpful.
-- Janice
