From: David Abrahams (dave_at_[hidden])
Date: 2004-12-02 13:50:28
Rob Stewart wrote:
> From: David Abrahams <dave_at_[hidden]>
>>Rene Rivera wrote:
>>>Rob Stewart wrote:
>>>>From: David Abrahams <dave_at_[hidden]>
>>>>>It's a basic principle of hierarchical documents that you should
>>>>>never have a section with only one subsection. Usually the solution
>>>>>is to raise the subsection up a level rather than adding an
>>>>I find it preferable to "Participation" being a major section,
>>>>but wouldn't mind a new "<H2>Purpose</H2>" before "The Boost web
>>>...Like it is now ;-)
>>>It does make it better, than just the participation section. Not
>>>it's much of a gain on the participation as a section. Other than
>>>bit easier to grasp the structure when it's only the Welcome/Intro
>>>News sections, instead of the three sections.
>>But this violates another principle: A section must always have content
>>that is not buried in a subsection.
> From whence do these principles come? I find them reasonable
> guidelines, but hardly unbending rules.
I learned them in school and they are supported by
Addison-Wesley as I found out while writing a book recently. I
think they use the Chicago Manual of Style as a base document.
Authoritative enough for you?
-- Dave Abrahams Boost Consulting http://www.boost-consulting.com
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk