docs: discourage usage of "devel" documentation

Users who landed on https://intel.github.io/pmem-csi/ or used
https://intel.github.io/pmem-csi/latest were told how to install the
development version of PMEM-CSI and then probably unintentionally
tried that instead of using the latest stable release.

We now make the latest stable release the main page, with "devel" in
the URL for the development version, "latest" as symlink for the
latest stable version (offered for those who still have those pages
bookmarked or in emails).

When pointing to documentation, we should always use the versioned
pages because those URLs are stable.

Author: pohly

.github/workflows/publish.yml

@@ -5,6 +5,8 @@ on:
     branches:
         - devel
         - release-0.7
+        - release-0.8
+        - release-0.9
 
 jobs:
   build:
@@ -23,16 +25,18 @@ jobs:
       run: |
         mkdir $HOME/output
         touch $HOME/output/.nojekyll
-        # This is the static index page for https://intel.github.io/pmem-csi,
-        # copied from the "devel" branch.
-        cp docs/html/index2.html $HOME/output/index.html
+        # https://intel.github.io/pmem-csi/ redirects to the latest stable release.
+        echo "<meta http-equiv=\"refresh\" content=\"0; URL='0.9/index.html'\" />" >"$HOME/output/index.html"
+        # "latest" used to be what "devel" is now, i.e. the documentation for the "devel"
+        # branch. Now it points to the latest stable release.
+        ln -s 0.9 "$HOME/output/latest"
     - name: Build latest
       run: |
         GITHUB_SHA=$(git rev-parse HEAD)
         export GITHUB_SHA
         rm -rf _work/venv
         make vhtml
-        mv _output/html $HOME/output/latest
+        mv _output/html $HOME/output/devel
     - uses: actions/checkout@v2
       with:
         ref: release-0.7

README.md

@@ -16,10 +16,10 @@ and bug fixes. Older releases are no longer supported.
 
 Documentation is part of the source code for each release and also
 available in rendered form for easier reading:
-- [latest documentation, in development](https://intel.github.io/pmem-csi/latest/)
-- [latest 0.7.x release](https://intel.github.io/pmem-csi/0.7/)
-- [latest 0.8.x release](https://intel.github.io/pmem-csi/0.8/)
 - [latest 0.9.x release](https://intel.github.io/pmem-csi/0.9/)
+- [latest 0.8.x release](https://intel.github.io/pmem-csi/0.8/)
+- [latest 0.7.x release](https://intel.github.io/pmem-csi/0.7/)
+- [latest documentation, in development](https://intel.github.io/pmem-csi/devel/)
 
 ## Supported Kubernetes versions