From: David Abrahams <dave@boost-consulting.com>
Rene Rivera wrote:
Rob Stewart wrote:
From: David Abrahams <dave@boost-consulting.com>
Rene Rivera wrote:
Right content changes... How do others feel? Should "Participation" be, or not, a section? ... I'll make a comparison page for people to look at..
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.
-- Rob Stewart stewart@sig.com Software Engineer http://www.sig.com Susquehanna International Group, LLP using std::disclaimer;