Skip to content

Conversation

@smithsg84
Copy link
Member

Add a workflow check to verify that the RELEASE_NOTES.md file has been edited. Release notes should be updated with a summary of what the PR does.

@rhornung67
Copy link
Member

The check failure seems to apply that this works! 😄

@smithsg84
Copy link
Member Author

The check failure seems to apply that this works! 😄

Yes it looks to be working. Will see if updating release notes works to fix the failure.

@rhornung67
Copy link
Member

It would be cool if it checked the release notes update against the git commit messages 😜

@smithsg84
Copy link
Member Author

That is probably coming, a test or two of having claude summarize a PR was interesting. It did catch that new input options were available, the technical details but didn't really set a context for why the change would be useful.

@rhornung67
Copy link
Member

rhornung67 commented Dec 24, 2025

Just having the CI check fail when the release notes have not been updated should be sufficient to make folks aware.

However, this raises an interesting topic for team discussion. IMO, the release notes should only document changes that are important for users to know. Every detail of the commit history leading to a release can be information overload which would likely discourage users from reading the release notes. For example, some projects use the GitHub feature that automatically generates release notes from the git log and cites every commit. I summarize the important changes in each PR merge when I manually write release notes and omit items that are only of interest to developers, such as internal implementation changes.

Does it make sense to allow ignoring the check by having the author of a PR insert a special comment in the release description?

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants