Re: [Boost-docs] Decoupling documentation builds from releasemanagement

Subject: Re: [Boost-docs] Decoupling documentation builds from releasemanagement
From: David Abrahams (dave_at_[hidden])
Date: 2008-12-13 03:20:33

on Thu Dec 11 2008, "John Maddock" <john-AT-johnmaddock.co.uk> wrote:

> Beman Dawes wrote:
>>>> One thing that we've lost since MetaComm stopped doing this, is the
>>>> automatic redirection from the "stub" docs that are in SVN to the
>>>> latest generated docs online.  So ideally we should have:
>>>>
>>>> * The latest build hosted somewhere within the boost.org domain so
>>>> that we can change doc-testers/builders without disruption to the
>>>> SVN HTML redirection code.
>>>
>>> Hum... Could you be a bit more explicit about that?
>
> Currently if I look at the docs in my SVN Trunk checkout, they try to
> redirect to (for example)
> http://www.boost.org/regression-logs/cs-win32_metacomm/doc/html/array.html,but
> no such URL exists because MetaComm have stopped doing their nightly
> build.  I'm suggesting we change that URL to redirect to some stable
> location within the boost.org domain, which whoever is running the
> nightly build can upload to.

One problem with the current site structure, IIUC, is that while there's
http://www.boost.org/doc/libs/1_37_0/libs/parameter/doc/html/index.html,
there's nothing like
http://www.boost.org/doc/libs/latest-release/libs/parameter/doc/html/index.html
and/or
http://www.boost.org/doc/libs/svn-trunk/libs/parameter/doc/html/index.html
that we could redirect to.

While I'm on a roll here, those URLs seem a bit long and redundant.  It
makes doing anything useful with the address bar quite difficult.
Couldn't that first link be shortened to something like:

  http://www.boost.org/doc/1_37_0/libs/parameter/index.html

?

-- 
Dave Abrahams
BoostPro Computing
http://www.boostpro.com