Skip to content

fix: read CHANGELOG.md from tagged commit during release#4764

Merged
markphelps merged 1 commit into
v2from
fix-changelog-from-tag
Sep 25, 2025
Merged

fix: read CHANGELOG.md from tagged commit during release#4764
markphelps merged 1 commit into
v2from
fix-changelog-from-tag

Conversation

@markphelps

Copy link
Copy Markdown
Collaborator

Summary

Fixes the issue where release announcements were reading the CHANGELOG.md from the wrong commit, resulting in incorrect or missing release notes.

Changes

  • Modified .github/prompts/release.md: Updated the AI prompt to explicitly read CHANGELOG.md from the tagged commit using git show {{.Tag}}:CHANGELOG.md instead of reading from the current working directory

Problem

The previous implementation (from PR #4757) was reading the CHANGELOG.md from the current branch state during the release process. This caused issues when:

  1. The CHANGELOG.md was updated after creating the release tag
  2. The release workflow ran from a different branch state than the tagged commit

Solution

The AI prompt now explicitly instructs to read the CHANGELOG.md content from the specific Git tag being released, ensuring the release notes always match the actual release content.

Additional Notes

This ensures consistency between the tagged release and its announcement, preventing confusion when the changelog is updated post-tagging.

The release announcement prompt now explicitly instructs to read
the CHANGELOG.md from the tagged commit (using git show {{.Tag}}:CHANGELOG.md)
rather than from the current working directory. This ensures the release
notes match the actual release content, not any subsequent changes that
may have been made to the main/v2 branch.

Fixes issue where release announcements contained incorrect changelog
content when the CHANGELOG.md was updated after tagging.

Signed-off-by: Mark Phelps <[email protected]>
@markphelps
markphelps requested a review from a team as a code owner September 24, 2025 23:59
@dosubot dosubot Bot added the size:XS This PR changes 0-9 lines, ignoring generated files. label Sep 24, 2025
@dosubot

dosubot Bot commented Sep 25, 2025

Copy link
Copy Markdown

Related Documentation

Checked 3 published document(s). No updates required.

You have 3 draft document(s). Publish docs to keep them always up-to-date

How did I do? Any feedback?  Join Discord

@markphelps
markphelps merged commit 6cfab3b into v2 Sep 25, 2025
16 of 28 checks passed
@markphelps
markphelps deleted the fix-changelog-from-tag branch September 25, 2025 11:53
@dosubot

dosubot Bot commented Sep 25, 2025

Copy link
Copy Markdown

Documentation Updates

Checked 3 published document(s). No updates required.

You have 3 draft document(s). Publish docs to keep them always up-to-date

How did I do? Any feedback?  Join Discord

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:XS This PR changes 0-9 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant