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

Boost list run by bdawes at, gregod at, cpdaniel at, john at