Updated version number documentation - 954

Here's a start on documenting the changes to version numbers that we discussed at Clustercon2014.

Fixes #954