Use readthedocs v2 config file

Monday, September 25, 2023: Fully remove support for building documentation without configuration file v2. Read the Docs will start requiring a .readthedocs.yaml configuration file for all projects in order to build documentation successfully. We will stop supporting builds without explicit configuration, because this creates implicit dependencies that users aren’t aware of. https://blog.readthedocs.com/migrate-configuration-v2/ Signed-off-by: Teoman ONAY <[email protected]> (cherry picked from commit c35a2a2)
ceph · Nov 21, 2023 · 6a3edae · 6a3edae
1 parent 6bd00c7
commit 6a3edae
Showing 1 changed file with 22 additions and 0 deletions.
diff --git a/.readthedocs.yaml b/.readthedocs.yaml
@@ -0,0 +1,22 @@
+# .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.11"
+
+# Build documentation in the docs/ directory with Sphinx
+sphinx:
+  configuration: doc/source/conf.py
+
+# We recommend specifying your dependencies to enable reproducible builds:
+# https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
+python:
+  install:
+    - requirements: ./requirements.txt