Boost logo

Boost :

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

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

   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

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

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