[boost] Re: Front page redesign...

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