Boost logo

Boost :

From: David Abrahams (dave_at_[hidden])
Date: 2004-12-01 16:36:43


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.

Heading 1
---------

   You need something here.

   Subheading 1.1
   --------------

      blah

   Subheading 1.2
   --------------

      blah blah.

-- 
Dave Abrahams
Boost Consulting
http://www.boost-consulting.com

Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk