[Boost-docs] 'Update to latest Boost version' option does not get to the right link

Subject: [Boost-docs] 'Update to latest Boost version' option does not get to the right link
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2015-05-27 11:59:17

I've been ticked off by a Wikipedia editor for not providing the approved citation  (links to
Wikipedia itself are not regarded as reliable - no self-referencing )  and I'm OK with that (one
must reference www.boost.org rather than Wikipedia article boost Libraries).

But I'm not sure if/how to provide a link to the function in question (in this case for example
float_next).

The user would like to just click on to the link float_next and get to the docs for that.

Or we can let a Well-Known Search Engine help us out, say searching for "boost.org float_next"

That works up to a point - it get to 

 
http://www.boost.org/doc/libs/1_52_0/libs/math/doc/sf_and_dist/html/math_toolkit/utils/next_float/fl
oat_next.html

but that isn't the most recent version.

There is a box acknowledging "This is an old version" and kindly offering to get the most recent
version (of the home page).

 
http://www.boost.org/doc/libs/1_58_0/libs/math/doc/html/math_toolkit/next_float/float_distance.html

but that just gets to http://www.boost.org/doc/libs/ which isn't really what the hapless wants :-(

Using the local search box does get you to the most recent, so that's just about OK, but not ideal.

However, I am left with the question of what to provide for the link to float_next for Wikipedia.

So far I have

  https://en.wikipedia.org/wiki/Unit_in_the_last_place#Language_support

(See ref 5)

Of course, the float_next link above will soon be out of date when version 1.59 hits the streets.
It would be nice to have a way of getting a link to the most recent version.  GIT might provide a
mechanism http://boostorg.github.io ?  but I am wary of that.

Any suggestions on doing better?

Paul

---
Paul A. Bristow
Prizet Farmhouse
Kendal UK LA8 8AB
[phone]