|
Boost : |
From: Rob Stewart (stewart_at_[hidden])
Date: 2004-12-02 12:17:41
From: David Abrahams <dave_at_[hidden]>
> Rene Rivera wrote:
> > Rob Stewart wrote:
> >> From: David Abrahams <dave_at_[hidden]>
> >>> 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..
> >>>>
> >>>> http://redshift-software.com/~grafik/boost/index-alt.htm
> >>>
> >>> 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_at_[hidden] Software Engineer http://www.sig.com Susquehanna International Group, LLP using std::disclaimer;
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk