RE: Scientfically numbered documents (Gov. manuals)

Subject: RE: Scientfically numbered documents (Gov. manuals)
From: "Jonathan West" <jwest -at- mvps -dot- org>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 25 Mar 2002 20:28:47 -0000


Hi Margie

>
> Need some advice ...
>
> When writing a document, which is scientifically numbered, does
> each heading
> need an introductory paragraph before having the next subnumber
> ... e.g., if
> I have roman "I" doesn't it need a paragraph/sentence that introduces 1.1
> and 1.2 ... doesn't 1.1 need an intro paragraph/sentence before 1.1.1 and
> 1.1.2
>
> I've always written with the introductory paragraph ... but that
> "necessity"
> has been called into question

The drafting rules for standards at the British Standards Institute
specifically say that you should *not* have text like this.

1 Heading 1
Some introductory text
1.1 Heading level 2
Some text
1.2 Another heading 2
Some text

Specifically, the text between 1 and 1.1 should not exist, unless it is an
informative note which makes no difference to the overall content and
meaning of the document.

They call this "hanging text". The reason they disapprove of it is that, if
you make a reference to clause 1 from elsewhere in the document, it is
unclear whether you are referring just to that text, or to clause 1 and all
its subclauses.

Where there is no hanging text, it is entirely clear that a reference to
clause 1 *must* include the subclauses, since there isn't anything else
there.

>
> Also ... what is the rule for numbered headings not being "orphaned". By
> that I mean, can you have a 1.1 without a 1.2? I've always contended that
> there need to be at least 2 or it really shouldn't be broken out as a
> separate item.

If you eliminate hanging text, it then becomes clear that it is pointless to
have only one subclause below a clause, you might as well eliminate the
unnecessary heading.

Sometimes, the content of hanging text is important, in which case, make it
a subclause of its own, and make the heading title "General" or
"Introduction" or something like that.

I could wish that some other standards organisations followed drafting rules
as carefull, it would eliminate a lot of errors and ambiguities in their
documents! :-(

Regards
Jonathan West


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
PC Magazine gives RoboHelp Office 2002 five stars - a perfect score!
"The ultimate developer's tool for designing help systems. A product
no professional help designer should be without." Check out RoboHelp at
http://www.ehelp.com/techwr
---
You are currently subscribed to techwr-l as: archive -at- raycomm -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.



References:
Scientfically numbered documents (Gov. manuals): From: Cowan, Margie

Previous by Author: RE: Data on who uses Help?
Next by Author: RE: Including Acrobat Reader on CD
Previous by Thread: Re: Scientfically numbered documents (Gov. manuals)
Next by Thread: RE: Scientfically numbered documents (Gov. manuals)


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


Sponsored Ads