RE: Paragraph numbering - industry standard?

Subject: RE: Paragraph numbering - industry standard?
From: eric -dot- dunn -at- ca -dot- transport -dot- bombardier -dot- com
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 4 Aug 2005 09:18:35 -0400


bounce-techwr-l-106467 -at- lists -dot- techwr-l -dot- com wrote on 08/03/2005 02:45:25 PM:
> Again, I don't see the point.

Know what? Firstly, as a technical writer it's not really our place to
"see the point". We have to give the customer/audience what they want.

What I find really ridiculous in these oft repeated rants against
paragraph numbering is that it is being done on the basis of design and
not communication/utility. Additionally, the griping is being done in an
age where adding the numbering is child's play once a template is set up.

If there is going to be ANY discussion about a document, numbering is
ESSENTIAL. It is precise and easy to enter in minutes of meetings.

If the document is going to be produced in many formats, identical
numbering in each format will provide a definite link between the two.

And if the document is ever printed, numbering gives the user quick access
to all information in the document without having to always go to an index
or remember page numbers. And an index instead? ROTFL! If you can't be
bothered to put the TINY effort into numbering the doc, what are the
chance the effort will be expended to index properly?

If the numbering also has technical meaning, it is also invaluable in
quickly navigating to relevant sections. Even without technical meaning,
it quickly identifies a paragraphs relationship to other sections. If
similar subjects are consistently broken into the same structure, finding
specific information about a new subject is as simple as scanning for the
numbering.

Even in the absence of consistent structure or technical meaning numbering
can be invaluable. The difference between 1.2.1 and 1.2.2.1 is obvious. In
an unnumbered document, slight changes in heading size and a variation in
layout is not necessarily obvious.

So, some think numbering is "ugly" and a hold over. I think unnumbered
docs are unwieldy to use and produced by people putting style over
substance, too lazy or incompetent to number, or who don't want their
organisational failures to be made clear by numbering.

Eric L. Dunn
Senior Technical Writer

_______________________________________________________________________________________________________________

This e-mail communication (and any attachment/s) may contain confidential
or privileged information and is intended only for the individual(s) or
entity named above and to others who have been specifically authorized to
receive it. If you are not the intended recipient, please do not read,
copy, use or disclose the contents of this communication to others. Please
notify the sender that you have received this e-mail in error by reply
e-mail, and delete the e-mail subsequently.
Thank you.
_________________________________________________________________________________________________________________


Ce message (ainsi que le(s) fichier/s), transmis par courriel, peut
contenir des renseignements confidentiels ou protégés et est destiné à
l?usage exclusif du destinataire ci-dessus. Toute autre personne est par
les présentes avisée qu?il est strictement interdit de le diffuser, le
distribuer ou le reproduire. Si vous l?avez reçu par inadvertance,
veuillez nous en aviser et détruire ce message.
Merci.
_________________________________________________________________________________________________________________




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

Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today! http://www.webworks.com/techwr-l


---
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- 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.



Follow-Ups:

References:
RE: Paragraph numbering - industry standard?: From: Claire Conant

Previous by Author: Re: meeting minutes--
Next by Author: Re: References (was: Why discuss certification?)
Previous by Thread: RE: Paragraph numbering - industry standard?
Next by Thread: Re: Paragraph numbering - industry standard?


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


Sponsored Ads