Fix documentation build issues

[tovrstra]

Our documentation build on read-the-docs (RTD) is failing. This should fix it, hopefully.

Because this can only be fully tested by merging the PR and monitoring the doc build in RTD, I will merge this soon.

Ideally, we get rid of RTD for the following reasons:

• RTD supports only one admin account per project, i.e. bus-factor 1 by construction, unless one shares passwords, which is a bad idea anyway.
• Testing the RTD build is only possible after merging.

As an alternative, we can build the documentation in a GitHub Action and host it on gh-pages instead.

[deepsource-io]

Here's the code health analysis summary for commits 6435bc3..034164e. View details on DeepSource ↗.

Analysis Summary

Analyzer	Status	Summary	Link
Shell	✅ Success		View Check ↗
Python	✅ Success		View Check ↗

---

💡 If you’re a repository administrator, you can configure the quality gates from the settings.

[sourcery-ai]

Hey @tovrstra - I've reviewed your changes and they look great!

Here's what I looked at during the review

• 🟡 General issues: 2 issues found
• 🟢 Security: all looks good
• 🟢 Testing: all looks good
• 🟢 Complexity: all looks good

---

Sourcery is free for open source - if you like our reviews please consider sharing them ✨

• X
• Mastodon
• LinkedIn
• Facebook

_{Help me be more useful! Please click 👍 or 👎 on each comment to tell me if it was helpful.}

[sourcery-ai]

suggestion: Hardcoding language to 'en' might limit flexibility.

Consider making the language configurable via an environment variable or a command-line argument to allow for easier localization in the future.

Suggested change

	language = "en"
	import os
	language = os.getenv('DOC_LANGUAGE', 'en')

[sourcery-ai]

suggestion: Consider enabling 'fail_on_warning' for stricter builds.

Enabling 'fail_on_warning' can help catch issues early by failing the build on any warnings, ensuring higher quality documentation.

Suggested change

	# Read the Docs configuration file for Sphinx projects
	# Read the Docs configuration file for Sphinx projects
	# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
	fail_on_warning: true

[PaulWAyers]

I agree, let's ditch read-the-docs. We're mostly using GitHub pages for everything else now anyway, and it's much nicer to deal with.