This commit updates the doc generation script to clear out the
/version/latest directory since it's not supposed to be there, and adds
a prompt for viewing the full diff.
This commit updates the spec to use a version number and updates our
hosted javadocs to be versioned too.
1. The spec now uses "release" for the full version
2. The spec uses "version" for the shortened release version ("1.0").
Docs across a minor version should all be compatible, and shipping
spec docs using a patch version might fragment links to the spec too
much.
3. The javadoc now uses the library version (which might be different
than the spec). A javadoc/latest/index.html file is created that
redirects to the latest version of the javadocs.
4. When building the docs, we no longer clear out the previous files,
this is key for continuing to host older version of the spec and
javadocs.