Boost logo

Boost :

From: Reid Sweatman (drunkardswalk_at_[hidden])
Date: 2004-09-29 22:39:22

> -----Original Message-----
> From: boost-bounces_at_[hidden]
> [mailto:boost-bounces_at_[hidden]] On Behalf Of Manfred Doudar
> Sent: Wednesday, September 29, 2004 7:12 PM
> To: boost_at_[hidden]
> Subject: Re: [boost] [Poll] New look-n-feel for Boost documentation
> Eric Niebler wrote:
> >
> > Joel de Guzman and I, with the help of many smart folks on the
> > boost-docs list[*], have been working on improving the
> look-n-feel of
> > Boost's documentation. We're ready to commit the new style,
> but wanted
> > to check here first.
> >
> > Volodya was good enough to put up a copy of Boost's docs
> with the new
> > style applied. You can preview them here:
> >
> >
> > Please say whether you like the new style or not. If not,
> be specific
> > about why.
> Speaking strictly as a user of these pages, I think it's
> definitely an
> improvement, much cleaner, and better from where we were.
> I would however suggest that an option (and only as an option) be
> provided to view a chapter in one page rather than having to navigate
> back and forth (with <- , -> at the bottom of the pages).
> Even better
> still, the "Table of Contents" for each chapter, if it were
> to appear on
> each page of the chapter would be very desirable, most useful and
> convenient.


I agree, especially with the remark concerning a single-page option; why not
turn that into a "print version" if possible? The two things I note are
that the numbering is left-justified, which isn't the norm for a TOC, and
that the items B, C, and D at the bottom of the first page don't correlate
syntactically with anything else on the page in an obvious manner, and beg
the obvious question concerning A.


Boost list run by bdawes at, gregod at, cpdaniel at, john at