Re: V2 documentation format: a resolution?

From: Christopher Currie (Christopher_at_[hidden])
Date: 2004-02-10 10:51:29

Vladimir Prus wrote:
>>There are several factors at work here. I think that some of the
>>*information* within the Boost.Build docs need to be reorganized. The
>>nesting is not arbitrary; it was based on the level of the header tags
>>in the original document (<h2> became a chapter, <h3> a first-level
>>section, etc.).
> 
> 
> That's for sure. But it's hard to expect that any rearrangment will leave us 
> with only chapters and first-level sections. There always will be 
> second-level sections.

True, but only first-level sections create separate html pages (under 
the current stylesheet). My point was not to eliminate the sections, but 
to perhaps make first-level sections longer and more cohesive, so that a 
single web page makes more sense on its own.

Christopher