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:
> > http://zigzag.lvk.cs.msu.su/~ghost/boost_docs/
> >
> > 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.
<snipped>
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.
Reid