ci: fix readthedocs [backport 2.0]

.readthedocs.yml

@@ -1,20 +1,10 @@
 version: 2
-
-sphinx:
-  builder: html
-  configuration: docs/conf.py
-  fail_on_warning: false
-
 build:
   os: ubuntu-22.04
   tools:
-    python: "3.8"
-  jobs:
-    post_checkout:
-      - git fetch --unshallow || true
-
-python:
-  install:
-    - requirements: docs/requirements.txt
-    - method: pip
-      path: .
+    python: "3.10"
+  commands:
+    - git fetch --unshallow || true
+    - pip install hatch==1.7.0 hatch-containers==0.7.0
+    - hatch -v run docs:sphinx-build -W -b html docs docs/_build/html
+    - mv docs/_build $READTHEDOCS_OUTPUT

hatch.toml

@@ -60,7 +60,6 @@ fmt = [
 ]
 
 [envs.docs]
-type = "container"
 template = "docs"
 dev-mode = false
 python = "3.10"
@@ -84,12 +83,8 @@ build = [
 ]
 
 [envs.docs.overrides]
-# CircleCI executor is an image already set up for docs
-# We skip the pre-install as well
-env.CIRCLECI.type = [
-    { value = "virtual", if = ["true"] },
-]
-
+# Local MacOS development requires Docker containers
+platform.macos.type = { value = "container" }
 
 [envs.slotscheck]
 template = "slotscheck"

scripts/docs/install.sh

@@ -4,6 +4,9 @@ set -ex
 
 if [[ "${CIRCLECI}" = "true" ]]; then
     echo "Skipping install"
+elif [[ "${READTHEDOCS}" = "True" ]]; then
+    # We skip here because we do not check spelling in RTD
+    echo "Skipping install"
 else
     export DEBIAN_FRONTEND="noninteractive"
     export DEBCONF_NOWARNINGS="yes"