chore: Update documentation build to use poetry / python 3.10 (#36)

pyproject.toml

@@ -23,8 +23,6 @@ initial-content = """
 
 [tool.poetry.dependencies]
 python = "^3.8"
-sphinx = ">=1.2.2, <1.6"
-sphinx_rtd_theme = ">=0.1.6, <1"
 lowdown = ">=0.1.0,<2"
 setuptools = ">=30.3.0"
 setuptools-scm = "^7.1.0"
@@ -43,6 +41,8 @@ wheel = "^0.41.2"
 black = "^23.7.0"
 pre-commit = "^3.4.0"
 twine = "^4.0.2"
+sphinx = "^7.0.6"
+sphinx_rtd_theme = ">=2.0.0,<3"
 
 [tool.poetry.group.test.dependencies]
 pytest = "^7.4.1"
@@ -53,4 +53,3 @@ flaky = "^3.7.0"
 [build-system]
 requires = ["poetry-core>=1.0.0", "poetry-dynamic-versioning>=1.0.0,<2.0.0"]
 build-backend = "poetry_dynamic_versioning.backend"
-

readthedocs.yaml

@@ -3,10 +3,16 @@ version: 2
 build:
   os: ubuntu-22.04
   tools:
-    python: "3.7"
+    python: "3.10"
 
-python:
-  install:
-    - requirements: doc/requirements.txt
-    - method: pip
-      path: .
+  jobs:
+    post_create_environment:
+      # Install poetry
+      # https://python-poetry.org/docs/#installing-manually
+      - pip install poetry
+    post_install:
+      # Install dependencies with 'docs' dependency group
+      # https://python-poetry.org/docs/managing-dependencies/#dependency-groups
+      # VIRTUAL_ENV needs to be set manually for now.
+      # See https://github.com/readthedocs/readthedocs.org/pull/11152/
+      - VIRTUAL_ENV=$READTHEDOCS_VIRTUALENV_PATH poetry install --with dev