The idea is to make the stable directory a symlink to the latest released documents, to remove one point of friction when releasing a new version. This is the way numpy does it: the stable symlink seamlessly works with github docs to point to the 1.19.0 docs

This has a merge conflict since the docs are updated every night somehow the stable docs got out of sync?. I will rebase fix it if I can convince the maintainers as to the approach, but then it must be merged before the next nightly build. Edit: Not clear why there is a conflict, the files on my checkout are identical.

The commits to reconstruct this were (on linux where symlinks work)

git checkout site
git pull
git checkout -b stable
cd docs
git rm -r 1.6.0
git commit -m"remove links in 1.6.0"
git mv stable 1.6.0
git commit -m"move stable to 1.6.0"
ln -s 1.6.0 stable
git add stable
git commit -m"recreate stable as a soft link to 1.6.0"
git push