Skip to content

Trim release notes to highlights when the changelog entry is huge - #18

Closed
Marcogn wants to merge 1 commit into
mainfrom
claude/release-pipeline-changelog-b0qz5k
Closed

Trim release notes to highlights when the changelog entry is huge#18
Marcogn wants to merge 1 commit into
mainfrom
claude/release-pipeline-changelog-b0qz5k

Conversation

@Marcogn

@Marcogn Marcogn commented Aug 19, 2026

Copy link
Copy Markdown
Owner

Summary

  • release.yml's "Extract changelog section for this version" step used to hand the entire cut ## vX.Y.Z section to softprops/action-gh-release verbatim, no matter its length — this project's entries routinely run to several thousand characters across many ### subsections (e.g. v2.4.0), making for an unreadable release page.
  • Sections at or under 1500 characters are still used verbatim, unchanged.
  • Past that threshold, the release body is reduced to just the section's ### subsection headings (or its top-level - **bold** bullets, for a version with no subsections), followed by a link back to CHANGELOG.md for the full write-up.
  • Added the required ## Unreleased CHANGELOG.md entry for this change, and updated the file's intro note to describe the new behavior.
  • Same change applied to Marcogn/CoverDex's release.yml for consistency between the two pipelines (separate PR).

Test plan

  • python3 -c "import yaml; yaml.safe_load(open('.github/workflows/release.yml'))" — YAML parses.
  • make test — all host suites still pass (17 + 13 + 6 tests), unaffected since this change touches only the workflow/changelog, not source/.
  • Ran the extraction logic standalone against the real CHANGELOG.md's v2.4.0 section (12408 chars, 8 subsections) — correctly collapses to an 8-line highlight list plus the CHANGELOG.md link.
  • Not run end-to-end via an actual workflow_dispatch (would cut a real release, and the real build requires devkitARM which isn't available in this sandbox).

Generated by Claude Code

The "Extract changelog section for this version" step used to hand the
whole cut CHANGELOG.md section to the GitHub Release body verbatim,
regardless of length -- fine for short entries, but this project's
entries routinely run to several thousand characters across many
"### " subsections (see v2.4.0), making for an unreadable release page.
Sections at or under 1500 characters still work that way; past that,
the body is reduced to the section's "### " subsection headings (or its
top-level "- **bold**" bullets, for a version with no subsections) plus
a link back to CHANGELOG.md for the full write-up. Same change applied
to CoverDex's release.yml for consistency between the two pipelines.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VQrE6ntdCMh5JQfS5m5WVL

Marcogn commented Aug 19, 2026

Copy link
Copy Markdown
Owner Author

Superseded by #19, which drops the 40-line cutoff entirely in favor of always extracting significant-change highlights (uniform with the same change in CoverDex and ThePatientGamerHelper). Closing this in favor of that PR.


Generated by Claude Code

@Marcogn Marcogn closed this Aug 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants