Merge https://github.com/jaraco/skeleton

# Conflicts:
#	.github/workflows/main.yml
#	docs/conf.py

Author: jaraco

.github/workflows/main.yml

@@ -16,16 +16,20 @@ jobs:
         distutils:
         - local
         python:
-        - 3.7-dev
-        - 3.10-dev
+        - "3.7"
+        - "3.10"
         # disabled due to #3365
-        # - 3.11-dev
-        - pypy-3.7
+        # - "3.11"
+        # Workaround for actions/setup-python#508
+        dev:
+        - -dev
         platform:
         - ubuntu-latest
         - macos-latest
         - windows-latest
         include:
+        - python: pypy3.9
+          platform: ubuntu-latest
         - platform: ubuntu-latest
           python: "3.10"
           distutils: stdlib
@@ -38,7 +42,7 @@ jobs:
       - name: Setup Python
         uses: actions/setup-python@v4
         with:
-          python-version: ${{ matrix.python }}
+          python-version: ${{ matrix.python }}${{ matrix.dev }}
       - uses: actions/cache@v3
         id: cache
         with:
@@ -149,7 +153,7 @@ jobs:
       - name: Setup Python
         uses: actions/setup-python@v4
         with:
-          python-version: "3.11-dev"
+          python-version: 3.11-dev
       - name: Install tox
         run: |
           python -m pip install tox

docs/conf.py

@@ -1,7 +1,15 @@
-extensions = ['sphinx.ext.autodoc', 'jaraco.packaging.sphinx', 'rst.linker']
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+extensions = [
+    'sphinx.ext.autodoc',
+    'jaraco.packaging.sphinx',
+]
 
 master_doc = "index"
 
+# Link dates and other references in the changelog
+extensions += ['rst.linker']
 link_files = {
     '../CHANGES.rst': dict(
         using=dict(
@@ -81,7 +89,7 @@
     ),
 }
 
-# Be strict about any broken references:
+# Be strict about any broken references
 nitpicky = True
 
 # Include Python intersphinx mapping to prevent failures
@@ -91,6 +99,9 @@
     'python': ('https://docs.python.org/3', None),
 }
 
+# Preserve authored syntax for defaults
+autodoc_preserve_defaults = True
+
 intersphinx_mapping.update({
     'pip': ('https://pip.pypa.io/en/latest', None),
     'build': ('https://pypa-build.readthedocs.io/en/latest', None),

setup.cfg

@@ -87,7 +87,7 @@ testing-integration =
 
 docs =
 	# upstream
-	sphinx
+	sphinx >= 3.5
 	jaraco.packaging >= 9
 	rst.linker >= 1.9
 	jaraco.tidelift >= 1.4