Boost logo

Boost :

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
>>>>>additional subsection.
>>>>
>>>>I find it preferable to "Participation" being a major section,
>>>>but wouldn't mind a new "<H2>Purpose</H2>" before "The Boost web
>>>>site...."
>>>
>>>...Like it is now ;-)
>>>
>>>It does make it better, than just the participation section. Not
sure if
>>>it's much of a gain on the participation as a section. Other than
it's a
>>>bit easier to grasp the structure when it's only the Welcome/Intro
plus
>>>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