Add RTD config (#183)

Author: ssbarnea

.readthedocs.yml

@@ -0,0 +1,25 @@
+---
+version: 2
+
+mkdocs:
+  fail_on_warning: true
+  configuration: docs/source/conf.py
+
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.12"
+  commands:
+    - pip install --user tox
+    - python3 -m tox -e docs
+python:
+  install:
+    - method: pip
+      path: tox
+    - method: pip
+      path: .
+      extra_requirements:
+        - docs
+submodules:
+  include: all
+  recursive: true

tox.ini

@@ -30,6 +30,7 @@ pass_env =
     PYTHONIOENCODING
     PYTHONPYCACHEPREFIX
     PY_COLORS
+    READTHEDOCS_OUTPUT
     REQUESTS_CA_BUNDLE
     RTD_TOKEN
     SETUPTOOLS_SCM_DEBUG
@@ -70,7 +71,7 @@ deps =
     -r{tox_root}/doc/requirements.txt
 commands =
     python -m doc8 -e .rst doc CONTRIBUTING.rst README.rst
-    sphinx-build -W -b html doc/source doc/build/html
+    sphinx-build -W -b html doc/source {env:READTHEDOCS_OUTPUT:doc/build}/html
 
 [testenv:packaging]
 description =