diff --git a/.readthedocs.yaml b/.readthedocs.yaml
new file mode 100644
index 000000000..dca7c8bc4
--- /dev/null
+++ b/.readthedocs.yaml
@@ -0,0 +1,21 @@
+# .readthedocs.yaml
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+# Set the version of Python and other tools you might need
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.9"
+
+# Build documentation in the docs/ directory with Sphinx
+sphinx:
+  configuration: doc/conf.py
+
+# Optionally declare the Python requirements required to build your docs
+python:
+  install:
+   - requirements: doc/requirements.txt
diff --git a/doc-requirements.txt b/doc/requirements.txt
similarity index 50%
rename from doc-requirements.txt
rename to doc/requirements.txt
index cf1a3a76e..123dcc0a2 100644
--- a/doc-requirements.txt
+++ b/doc/requirements.txt
@@ -6,3 +6,4 @@ sphinx_rtd_theme
 numpydoc
 ipykernel
 nbsphinx
+docutils==0.16 # pin until sphinx_rtd_theme is compatible with 0.17 or later