RE: Punctuation lists- an exhaustive scenarios list

Subject: RE: Punctuation lists- an exhaustive scenarios list
From: "Janoff, Steve" <Steve -dot- Janoff2 -at- Teradata -dot- com>
To: "techwr-l List" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 13 Oct 2009 15:29:21 -0400

Yes, but the original poster is asking what to do in cases where
bulleted lists are necessary. Presumably you're not going to get rid of
all bulleted lists.

-----Original Message-----
From: techwr-l-bounces+steve -dot- janoff2=teradata -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+steve -dot- janoff2=teradata -dot- com -at- lists -dot- techwr-l -dot- com]
On Behalf Of Peter Neilson
Sent: Tuesday, October 13, 2009 11:58 AM
To: techwr-l List
Subject: Re: Punctuation lists- an exhaustive scenarios list

Pinkham, Jim wrote in answer to Rob Hudson's question:
> There's probably more than one feasible answer to this.

One feasible answer is to cut back drastically on the use of bulleted
lists. They are probably overused, and in my estimation should never
appear within other lists--bulleted, enumerated, or any other sort.

When a document consists of a plethora of bulleted lists, it is probable
that the technical writer has failed to do some much-needed work.
Perhaps no technical writer has yet been allowed to touch it.

When one's mind is fidgiting over how to punctuate a bulleted list, one
just might be receiving a sign that the structure of the document is
faulty. Perhaps its entire purpose is misunderstood.

Rob, I'm sorry if my salvo entirely misses your target, but that's the
way I see things. I hope that I'm occasionally able to write up to the
standard I'm setting forth.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Free Software Documentation Project Web Cast: Covers developing Table of
Contents, Context IDs, and Index, as well as Doc-To-Help
2009 tips, tricks, and best practices.
http://www.doctohelp.com/SuperPages/Webcasts/

Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/

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


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
http://www.techwr-l.com/ for more resources and info.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


Follow-Ups:

References:
Punctuation lists- an exhaustive scenarios list: From: Rob Hudson
RE: Punctuation lists- an exhaustive scenarios list: From: Pinkham, Jim
Re: Punctuation lists- an exhaustive scenarios list: From: Peter Neilson

Previous by Author: RE: Business Travel and an Interesting List of Local Attractions
Next by Author: RE: reinvite or re-invite?
Previous by Thread: Re: Punctuation lists- an exhaustive scenarios list
Next by Thread: Re: Punctuation lists- an exhaustive scenarios list


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


Sponsored Ads