diff --git a/.readthedocs.yaml b/.readthedocs.yaml
index c1d97eb3..9e7361c7 100644
--- a/.readthedocs.yaml
+++ b/.readthedocs.yaml
@@ -1,11 +1,22 @@
+# Read the Docs configuration file for Sphinx projects
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
 version: 2
 
+# Set the OS, Python version and other tools you might need
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.12"
+
 # Build from the docs/ directory with Sphinx
 sphinx:
   configuration: docs/conf.py
 
-# Explicitly set the version of Python and its requirements
+# Optional but recommended, declare the Python requirements required
+# to build your documentation
+# See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
 python:
-  version: 3.7
   install:
     - requirements: docs/requirements.txt