chore(release): render docs in the changelog and widen the commitlint scopes

.github/workflows/commitlint.yml

@@ -30,8 +30,10 @@ jobs:
                 "chore", "docs", "test", "tests", "style", "ci", "perf"
               ]],
               "scope-enum": [1, "always", [
-                "core", "helpers", "deps", "release", "ci",
-                "version", "hmac", "docs", "tests", "examples"
+                "core", "helpers", "client", "auth", "statcalc",
+                "exceptions", "cache", "defaults", "typing", "hmac",
+                "version", "deps", "release", "changelog", "ci",
+                "docs", "tests", "examples", "parity"
               ]],
               "subject-max-length": [1, "always", 100],
               "header-max-length": [0, "always"],

.github/workflows/prepare-release.yml

@@ -64,7 +64,9 @@ jobs:
           git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
           git switch -c "${branch}"
           git add CHANGELOG.md
-          git commit -m "docs(changelog): update for ${tag}"
+          # `chore` keeps this bookkeeping commit out of the rendered sections;
+          # `docs` would list every release's regeneration in the next release.
+          git commit -m "chore(changelog): update for ${tag}"
           git push --force-with-lease origin "${branch}"
           gh pr create \
             --base main --head "${branch}" \

pyproject.toml

@@ -159,6 +159,9 @@ in-place = true
 output = "CHANGELOG.md"
 marker-line = "<!-- insertion marker -->"
 bump = "auto"
+# The angular convention renders only feat/fix/revert/refactor/perf by default.
+# Listing them explicitly is what lets `docs` join them.
+sections = ["feat", "fix", "revert", "refactor", "perf", "docs"]
 
 # ── Coverage ─────────────────────────────────────────────────────────────