🐛 fix(release): generate docstrfmt-compatible changelog entries (#463)

Author: gaborbernat

.github/workflows/release.yaml

@@ -81,10 +81,10 @@ jobs:
           git config user.name "${{ github.actor }}"
           git config user.email "${{ github.actor_id }}+${{ github.actor }}@users.noreply.github.com"
           header=" $VERSION ($(date -u +%Y-%m-%d))"
-          separator=$(printf '%0.s*' $(seq 1 ${#header}))
+          separator=$(printf '%0.s*' $(seq 1 $((${#header} + 1))))
           {
             head -4 docs/changelog.rst
-            printf '%s\n%s\n%s\n%s\n\n' "$separator" "$header" "$separator" "$CHANGELOG"
+            printf '%s\n%s\n%s\n\n%s\n\n' "$separator" "$header" "$separator" "$CHANGELOG"
             tail -n +5 docs/changelog.rst
           } > docs/changelog.tmp
           mv docs/changelog.tmp docs/changelog.rst

docs/changelog.rst

@@ -2,9 +2,10 @@
  Changelog
 ###########
 
-*******************
+********************
  4.9.4 (2026-03-05)
-*******************
+********************
+
 - [pre-commit.ci] pre-commit autoupdate :pr:`461` - by :user:`pre-commit-ci[bot]`
 - Update README.md
 - 📝 docs: add project logo to documentation :pr:`459`

tasks/changelog.py

@@ -61,7 +61,7 @@ def run() -> None:
 
 
 def _load_excluded_authors() -> set[str]:
-    release_config = ROOT / ".github" / "release.yml"
+    release_config = ROOT / ".github" / "release.yaml"
     if release_config.exists():
         with release_config.open(encoding="utf-8") as file_handler:
             config = yaml.safe_load(file_handler)