From: David Abrahams <dave@boost-consulting.com>
Rene Rivera wrote:
Rob Stewart wrote:
From: David Abrahams <dave@boost-consulting.com>
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
Rob Stewart wrote: 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