Update documentation theme

[bvreede]

This PR updates the documentation theme; this way, we don't have to look at the ugly alabaster theme when we update the documentation 🙃

We have changed the settings on Readthedocs so it will automatically show a preview of documentation as part of a PR. Follow the link below (in the checks) or see the updated docs here.

This was (eventually) found in Admin > Advanced settings > Build pull requests for this project.

[codecov]

Codecov Report

❗ No coverage uploaded for pull request base (main@970226a). Click here to learn what that means.
The diff coverage is n/a.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #125   +/-   ##
=======================================
  Coverage        ?   98.94%           
=======================================
  Files           ?        6           
  Lines           ?      379           
  Branches        ?        0           
=======================================
  Hits            ?      375           
  Misses          ?        4           
  Partials        ?        0           

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 970226a...6a0cd65. Read the comment docs.

[BSchilperoort]

Hi Barbara, this theme does look a lot better! Nice that you got the PR-doc build enabled as well, that can really help with reviewing changes to the docs.

I was wondering why there are three docs-related badges in ./README.rst though. Perhaps that can be reduced to only show the docs status as there is another link to the documentation at the bottom of the readme :)

[bvreede]

Thanks @BSchilperoort — yeah, very good point, it's indeed a bit excessive. The main advantage is that there is an explicit reference to stable vs latest documentation, but honestly, there should not really be a (big) difference between those, and it's really only confusing.

I've now changed the status badge to refer to "latest" documentation (which is also what the link at the bottom of the README refers to), and removed the two other docs badges.