Merge pull request #365 from Pylons/tseaver-docstring-cleanup

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