Fix links in readthedocs to stable version

[mloning]

Reference Issues/PRs

#386

What does this implement/fix? Explain your changes.

In our docs, binder button on top of notebooks should point to correct version since we're now using versioned docs. On master, binder link in README should point to master branch and build based on master.

Wasn't sure how to best solve this, options included:

• using a postBuild file,
• using a Dockerfile,
• installing from nightly builds (see e.g. scikit-learn)

For now I've added a Dockerfile. postBuild would have required to move all binder related config files from the .binder/ folder into the root directory. Setting up nightly builds and wheel storage requires much more work.

This seems to solve most links, except the link of the binder launch button on the README.rst which will still point to master even if you're viewing the documentation for one of the stable versions on readthedocs.

Comments

• reset settings to always run notebooks in conf.py, here disabled for faster debugging

Speeding up build can be achieved by building the docker image separately in a GitHub Action: see this post, this GitHub Action and this example