Skip to content

Console release notes script#3465

Open
JohnBlackwell wants to merge 5 commits intomasterfrom
john/prod-4579-write-github-script-to-generate-deep-patch-notes-for-plural
Open

Console release notes script#3465
JohnBlackwell wants to merge 5 commits intomasterfrom
john/prod-4579-write-github-script-to-generate-deep-patch-notes-for-plural

Conversation

@JohnBlackwell
Copy link
Copy Markdown
Contributor

@JohnBlackwell JohnBlackwell commented Apr 21, 2026

For each PR, it checks the git diff in order to generate a more accurate summary of the PR. If an LLM is enabled, it's provided with Plural docs to get context when generating a description.

Test Plan

ran python3 .github/scripts/generate-release-notes.py v0.12.15 (or use tag of your choice) and compared the notes with what is in the current release notes.

optionally export OPENAI_API_KEY to get the LLM-generated description

Checklist

  • If required, I have updated the Plural documentation accordingly.
  • I have added tests to cover my changes.
  • I have added a meaningful title and summary to convey the impact of this PR to a user.

Plural Flow: console

@linear
Copy link
Copy Markdown

linear Bot commented Apr 21, 2026

@JohnBlackwell JohnBlackwell added the enhancement New feature or request label Apr 21, 2026
@JohnBlackwell JohnBlackwell marked this pull request as ready for review April 21, 2026 21:17
@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented Apr 21, 2026

Greptile encountered an error while reviewing this PR. Please reach out to support@greptile.com for assistance.

Copy link
Copy Markdown
Member

@michaeljguarino michaeljguarino left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

so we shouldn't just put these in the github release notes like you're seeing there, but also in a changelog (which is a common pattern in most repos)

"""Prepend release notes to the changelog file."""
from datetime import date

header = f"# {tag} ({date.today().isoformat()})\n\n"
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Look at how other repos define their changelogs, this isn't really in line. There's usually a CHANGELOG.md file that references seaprate files (named by the release semver) for each version.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I didn't push it up with that last commit. As a random repo example I think it looks in-line with a hashicorp changelog: https://github.com/hashicorp/consul/blob/main/CHANGELOG.md

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

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants