diff --git a/.readthedocs.yml b/.readthedocs.yml
new file mode 100644
index 0000000000000000000000000000000000000000..8f70f5c038470dea1c5863107ff1fe7731322497
--- /dev/null
+++ b/.readthedocs.yml
@@ -0,0 +1,23 @@
+# .readthedocs.yml
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+# Build documentation in the docs/ directory with Sphinx
+# sphinx:
+#   configuration: docs/conf.py
+
+# Build documentation with MkDocs
+mkdocs:
+ configuration: mkdocs.yml
+
+# Optionally build your docs in additional formats such as PDF and ePub
+formats: all
+
+# Optionally set the version of Python and requirements required to build your docs
+python:
+  version: 3.7
+  install:
+    - requirements: docs-requirements.txt
diff --git a/doc-requirements.txt b/doc-requirements.txt
new file mode 100644
index 0000000000000000000000000000000000000000..ccba8f4dcab3751109fc8297fd2da85fbfb96318
--- /dev/null
+++ b/doc-requirements.txt
@@ -0,0 +1,3 @@
+mkdocs>=1.1,<2
+mkdocs-material
+mdx_truly_sane_lists