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

From: David Abrahams (dave_at_[hidden])
Date: 2004-03-27 19:03:20

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.

-- 
Dave Abrahams
Boost Consulting
www.boost-consulting.com