[Author Prev][Author Next][Thread Prev][Thread Next]
[Author Index (this month)][Thread Index (this month)][Top of Archive]

Re: Paragraph numbering - industry standard?

Subject: Re: Paragraph numbering - industry standard?
From: Jefro <jefro -at- jefro -dot- net>
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 03 Aug 2005 13:10:54 -0700


Are we discussing section numbering or paragraph numbering? I assumed that "paragraph numbering" meant itemizing each paragraph. Third- or fourth-level sections are useful and commonplace; numbering individual paragraphs is neither, in my opinion, at least for software documentation.


Sarah, I know it's ugly and cumbersome, but numbering each paragraph helps programmers (and sometimes writers) speak more effectively about that paragraph. I'd like to draw your attention to section 5.2.1.1., so I'd say, ugly though it is, you should probably keep numbering paragraphs if most of your audience is techies.


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

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:
Paragraph numbering - industry standard?: From: siliconwriter
Re: Paragraph numbering - industry standard?: From: Michele

Previous by Author: FrameMaker Crash
Next by Author: online job hunt -- for telecommuters
Previous by Thread: Re: Paragraph numbering - industry standard?
Next by Thread: Re: Paragraph numbering - industry standard?

[Top of Archive] | [Author Index (this month)] | [Thread Index (this month)]

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

Sponsored Ads