Re: [boost] [website] libs/* --> doc/libs/BOOST_VERSION/libs/* rewriting rule

Subject: Re: [boost] [website] libs/* --> doc/libs/BOOST_VERSION/libs/* rewriting rule
From: David Abrahams (dave_at_[hidden])
Date: 2008-10-10 14:28:03

on Thu Oct 09 2008, joaquin-AT-tid.es wrote:

> Hello,
>
> The website PHP is devised in such a way that documentation URLs are automatically
> rewritten to point to the specific Boost version most recently shipped. For instance,
> if I type the following in my browser:
>
>  http://www.boost.org/libs/smart_ptr/smart_ptr.htm
>
> I get the following redirection:
>
>  http://www.boost.org/doc/libs/1_36_0/libs/smart_ptr/smart_ptr.htm
>
> This is fine in that it allows us to keep a historic record of documentation across
> Boost versions. My little complain is that the automatic redirection makes it all
> too easy to inadvertently use version-specific URLs when referring to Boost
> docs in external contexts (blogs, forums, etc.) This is in my opinion unfortunate
> because such URLs are stuck in time and do not reflect the evolution of
> the library. 

It would be nice to have

http://www.boost.org/doc/libs/latest/libs/smart_ptr/smart_ptr.htm

with each versioned page having a link to the "most recent version of
this document."

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