RE: [boost] Re: Suggestion: link to the libraries page not easy to find

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