[keycloak-dev] Latest and archive version for documentation

[Stian Thorgersen]

Google (and probably others, are there any?) keeps insisting on returning
random versions of the documentation when searching.

To improve on this I've made two changes to the documentation:

* Add a version to the top of the documentation, including latest or link
to latest if not the latest
* For the latest version, all cross-links within the documentation now uses
/latest/ in the url, while in the past it had the version in the link

One minor issue is that we need to build the documentation twice when doing
a release, but that's not a big deal. As we need to build the
version/archive build as well as the latest build separately. When building
docs just include the -Platest to build the latest, by default it will
build version/archive.

PR for this is here:
https://github.com/keycloak/keycloak-documentation/pull/770

This is how it looks like:

[image: docs-archive.png]
[image: docs-latest.png]
-------------- next part --------------
A non-text attachment was scrubbed...
Name: docs-archive.png
Type: image/png
Size: 49340 bytes
Desc: not available
Url : http://lists.jboss.org/pipermail/keycloak-dev/attachments/20191106/90c549b3/attachment-0002.png 
-------------- next part --------------
A non-text attachment was scrubbed...
Name: docs-latest.png
Type: image/png
Size: 47156 bytes
Desc: not available
Url : http://lists.jboss.org/pipermail/keycloak-dev/attachments/20191106/90c549b3/attachment-0003.png