TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:RE: punctuation in bullet text From:"Rene Stephenson" <rinnie1 -at- yahoo -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Thu, 6 May 2004 22:42:50 -0400
Peter has asked about punctuating bulleted lists.
Hi Peter,
Well, you've got parallelism, which is more than I see in many bulleted
lists. ;-) In American English, it is acceptable to allow the bullet to
function as quasi-punctuation. In this case, you would capitalize each
phrase but omit any ending punctuation, especially since the list is
sentence fragments. Your example would appear as, "...It is used to:
- Identify and understand the context and reviewing the text in its entirety
- Make sure that the words, sentences, and punctuation of the text express
effectively and precisely what the dictator desires
- Ensure that the references to sources are accurate and that citations in
the text match the list of references"
However, it is also acceptable (and probably clearer, due to specifying
"and" or "or") to punctuate the bulleted as one would read it in paragraph
form:
- Identify and understand the context and reviewing the text in its
entirety,
- Make sure that the words, sentences, and punctuation of the text express
effectively and precisely what the dictator desires, and
- Ensure that the references to sources are accurate and that citations in
the text match the list of references.
Of course, much is left to the preference of the editor, if there is such a
player on your team. ;-) Some editors would take issue with the fact that
the structure of the intro phrase + the list creates split infinitives, but
I'm less rigid than that. ;-)
If there isn't an editor, just be consistent with the way you treat all the
bulleted lists in your documents. Maintain parallelism and initial caps, and
either always punctuate minimally, or always punctuate as it would appear in
a paragraph. If you're making the decision yourself, you might consider that
the less punctuated route comes off as a bit less formal, if not less
polished, but it would be the better way to go if the overall tone of the
document is informal, and the audience isn't particularly uptight. :-)
I apologize if my comments spark a conflagration...
SEE THE ALL NEW ROBOHELP X5 IN ACTION: RoboHelp X5 is a giant leap forward
in Help authoring technology, featuring Word 2003 support, Content
Management, Multi-Author support, PDF and XML support and much more! http://www.macromedia.com/go/techwrldemo
>From a single set of Word documents, create online Help and printed
documentation with ComponentOne Doc-To-Help 7 Professional, a new yearly
subscription service offering free updates and upgrades, support, and more. http://www.doctohelp.com
---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.