From 693cd487ae61ef1e935b495a45d46f4de9ac2772 Mon Sep 17 00:00:00 2001
From: Charles-Henri de Boysson <ceache@users.noreply.github.com>
Date: Sun, 12 Feb 2023 09:43:24 -0500
Subject: docs: Use `.readthedocs.yaml` to configure the build

---
 .readthedocs.yaml | 32 ++++++++++++++++++++++++++++++++
 constraints.txt   |  6 ------
 2 files changed, 32 insertions(+), 6 deletions(-)
 create mode 100644 .readthedocs.yaml

diff --git a/.readthedocs.yaml b/.readthedocs.yaml
new file mode 100644
index 0000000..95420fe
--- /dev/null
+++ b/.readthedocs.yaml
@@ -0,0 +1,32 @@
+# .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.7"
+    # You can also specify other tool versions:
+    # nodejs: "19"
+    # rust: "1.64"
+    # golang: "1.19"
+
+# Build documentation in the docs/ directory with Sphinx
+sphinx:
+  configuration: docs/conf.py
+
+# If using Sphinx, optionally build your docs in additional formats such as PDF
+formats: []
+#    - pdf
+
+# Optionally declare the Python requirements required to build your docs
+python:
+  install:
+  - method: pip
+    path: .
+    extra_requirements:
+    - docs
diff --git a/constraints.txt b/constraints.txt
index dfc5457..42c8b14 100644
--- a/constraints.txt
+++ b/constraints.txt
@@ -5,9 +5,3 @@ flake8==5.0.2
 objgraph==3.5.0
 pytest==6.2.5
 pytest-cov==3.0.0
-
-# Documentation building.
-Jinja2==2.7.3
-Pygments==1.6
-Sphinx==1.2.2
-docutils==0.12
-- 
cgit v1.2.1


From e24e1200351bac10c0fb9f23608bc385b35afb49 Mon Sep 17 00:00:00 2001
From: Charles-Henri de Boysson <ceache@users.noreply.github.com>
Date: Tue, 14 Feb 2023 16:50:02 -0500
Subject: docs: Include type hints in docs

---
 docs/conf.py | 1 +
 setup.cfg    | 1 +
 2 files changed, 2 insertions(+)

diff --git a/docs/conf.py b/docs/conf.py
index fb1d598..17b3ff4 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -42,6 +42,7 @@ extensions = [
     "sphinx.ext.autodoc",
     "sphinx.ext.doctest",
     "sphinx.ext.viewcode",
+    "sphinx_autodoc_typehints",
 ]
 
 # Add any paths that contain templates here, relative to this directory.
diff --git a/setup.cfg b/setup.cfg
index 2f29292..63d3ac6 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -71,6 +71,7 @@ sasl =
 
 docs =
     Sphinx>=1.2.2
+    sphinx-autodoc-typehints>=1
 
 typing =
     mypy>=0.991
-- 
cgit v1.2.1