docs: conform docstrings to PEP257

.github/workflows/ci-tests.yml

@@ -25,15 +25,16 @@ jobs:
  os:
  - "ubuntu-latest"
  - "windows-latest"
- - "macos-latest"
+ # later versions no longer support Python < 3.10.
+ - "macos-11"
  architecture:
  - x64
  - x86
  exclude:
  # Linux and macOS don't have x86 python
  - os: "ubuntu-latest"
  architecture: x86
- - os: "macos-latest"
+ - os: "macos-11"
  architecture: x86
  name: "Python: ${{ matrix.py }}-${{ matrix.architecture }} on ${{ matrix.os }}"
  runs-on: ${{ matrix.os }}

.readthedocs.yaml

@@ -0,0 +1,17 @@
+# https://docs.readthedocs.io/en/stable/config-file/v2.html
+version: 2
+build:
+ os: ubuntu-22.04
+ tools:
+ python: '3.12'
+sphinx:
+ configuration: docs/conf.py
+formats:
+ - pdf
+ - epub
+python:
+ install:
+ - method: pip
+ path: .
+ extra_requirements:
+ - docs

MANIFEST.in

@@ -15,6 +15,7 @@ include CHANGES.rst
 include setup.cfg pyproject.toml
 include .coveragerc .flake8 pytest.ini
 include tox.ini rtd.txt
+include .readthedocs.yaml
 
 exclude TODO.txt