Skip to content

ci: add automated release notes generation - #2018

Merged
Haven Xia (HavenXia) merged 1 commit into
agent-substrate:mainfrom
stshrive:dev/release-notes
Oct 1, 2026
Merged

Haven Xia (HavenXia) merged 1 commit into
agent-substrate:mainfrom
stshrive:dev/release-notes

Conversation

@stshrive

@stshrive Steven Shriver (stshrive) commented Sep 30, 2026 •

Copy link
Copy Markdown
Collaborator
  • Add two new labels: breaking-change and release-note/none.
  • Add .github/release.yml so GitHub's generated release notes follow the v0.2.0 layout:
    • Breaking Changes
    • Bug Fixes
    • Documentation
    • per-area feature sections
    • Dependencies
    • Other Changes.
  • docs/dev/release-notes.md covers the sections, PR titles, and the release steps.
  • Points to the new doc content via PR template and CONTRIBUTING
  • Pushing vX.Y.Z or vX.Y.Z-PRE runs hack/release/draft-release.sh which creates a draft release (a prerelease for -PRE tags) with notes from .github/release.yml plus a committer list, as in v0.1.0 and v0.2.0. A maintainer edits and publishes the draft.

Fixes #2017

Comment thread docs/dev/release-notes.md Resolved
Comment thread docs/dev/labels/README.md Resolved
Comment thread .github/release.yml Resolved
Comment thread .github/release.yml Resolved
Comment thread docs/dev/labels/README.md Resolved
Comment thread .github/release.yml Resolved
- Add `docs/dev/labels/README.md` as the canonical label taxonomy
  for issues and pull requests,
  - Add two new labels: `breaking-change` and `release-note/none`.
  - The `kind/*` and `area/*` definitions come from the triage-issues
    skill, which now point at the `labels/README.md`
  - Add .github/release.yml so GitHub's generated release notes follow
    the `v0.2.0` layout:
    - Breaking Changes
    - Bug Fixes
    - Documentation
    - per-area feature sections
    - Dependencies
    - Other Changes.
- `docs/dev/release-notes.md` covers the sections, PR titles, and the
  release steps.
- Points to the new doc content via PR template and CONTRIBUTING
- Enforces that a PR contains a label for release note generation.
  - Runs `hack/release/check-pr-labels.sh` against a PR's labels to ensure
    it has one `kind/*` label (or `dependencies` / `release-note/none`), an
    `area/*` label for features and breaking changes, and no contradictory
    pair.
- Pushing `vX.Y.Z` or `vX.Y.Z-PRE` runs `hack/release/draft-release.sh`
  which creates a draft release (a prerelease for -PRE tags) with notes
  from `.github/release.yml` plus a committer list, as in `v0.1.0` and
  `v0.2.0`. **A maintainer edits and publishes the draft.**

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

ty for getting this out so quickly!

@HavenXia Haven Xia (HavenXia) left a comment

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.

LGTM

@HavenXia
Haven Xia (HavenXia) added this pull request to the merge queue Oct 1, 2026
Merged via the queue into agent-substrate:main with commit b1bdc59 Oct 1, 2026
10 checks passed
@stshrive
Steven Shriver (stshrive) deleted the dev/release-notes branch October 26, 2026 17:52
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.

Automate release notes for version cuts

4 participants