From: Reid Sweatman (drunkardswalk_at_[hidden])
Date: 2004-03-28 03:08:45


> -----Original Message-----
> From: boost-bounces_at_[hidden]
> [mailto:boost-bounces_at_[hidden]] On Behalf Of David Abrahams
> Sent: Saturday, March 27, 2004 5:03 PM
> To: boost_at_[hidden]
> Subject: [boost] Re: Suggestion: link to the libraries page
> not easy to find
>
>
> Marcello Pietrobon <teiffel_at_[hidden]> writes:
>
> > Thank you for both nice answers.
> > I definitely must be tired.
>
> Maybe, but I think we have a real problem.
>
> > Or maybe for a person knowing where to go it is obvious, but not for
> > the other people,
>
> Yeah, I think the current organization is pretty confusing. I suggest
> one top-level link:
>
> Documentation - points to complete docs for latest
> release
>
> A link to the up-to-date docs for the CVS should be hidden away
> (slightly) on the page targeted by the above link. It could be
> either:
>
> Generated Docs (Nightly Build) - points to subset of docs that are
> generated from boostbook sources,
> with a clear note at the top of
> the link's target page saying that
> it's only a subset of the complete
> docs
>
> or, better:
>
> Nightly CVS docs - Integrates the boostbook docs rebuilt nightly
> with a the docs that are stored in CVS as HTML,
> yielding a page with the same format as the
> "Documentation" page. The non-boostbook docs
> can be acquired via nightly download or simply
> linked-to using CVSWeb.

Although I elsewhere and severally retracted my original comments as being
slightly to the left of reality, I think the organization you suggest is
somewhat better than the existing one. So one person throws his nickle on
the grass for this one, in any event.

Reid