Skip to content

ci: add CHANGELOG and prefer it for GitHub release notes - #4

Merged
fqueis merged 2 commits into
mainfrom
chore/release-notes-changelog
Jul 24, 2026
Merged

ci: add CHANGELOG and prefer it for GitHub release notes#4
fqueis merged 2 commits into
mainfrom
chore/release-notes-changelog

Conversation

@fqueis

@fqueis fqueis commented Jul 24, 2026

Copy link
Copy Markdown
Owner

Description

Adds a Keep a Changelog–style CHANGELOG.md for release history and updates the publish workflow so GitHub Release notes prefer the matching version section from that file. When no section exists, the workflow falls back to gh --generate-notes from the previous v* tag, or an initial-release stub when none is found. The README now points readers at the changelog and this release-notes behavior.

Key Changes & Features Implemented

Documentation

  • Add CHANGELOG.md documenting 1.0.0 and 1.1.0 (opt-in call_endpoint, related env vars, and supporting changes) (ddc9929)
  • Link release history from README and note that GitHub Release notes use the matching changelog section when present (ddc9929)

CI / Release Publishing

  • Extract ## [version] from CHANGELOG.md for release notes before creating the GitHub Release (21be580)
  • Fall back to gh release create --generate-notes since the previous v* tag when no changelog section exists (21be580)
  • Use an initial-release notes stub when there is no changelog section and no prior v* tag (21be580)

How to Test

  1. Confirm CHANGELOG.md includes a ## [1.1.0] section and that README links to it.
  2. Dry-run or review .github/workflows/publish.yml release-notes step: with a matching changelog section, notes should come from that section.
  3. Ensure package version remains 1.1.0 (no product code changes in this PR).

fqueis added 2 commits July 23, 2026 23:33
- Created a new CHANGELOG.md file to track notable changes and adhere to Semantic Versioning.
- Documented the features and changes introduced in version 1.1.0, including the optional HTTP execution for registered backends and related environment variables.
- Updated README.md to reference the new CHANGELOG for release history.
- Updated the publish workflow to improve release notes handling by extracting sections from CHANGELOG.md based on the current version.
- Implemented logic to generate release notes from the previous tag if no CHANGELOG section exists.
- Enhanced initial release handling to create a stub when no prior tags are found.
@fqueis fqueis self-assigned this Jul 24, 2026
@fqueis fqueis added the enhancement New feature or request label Jul 24, 2026
@fqueis
fqueis merged commit 0dead7d into main Jul 24, 2026
2 checks passed
@fqueis
fqueis deleted the chore/release-notes-changelog branch July 24, 2026 02:36
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.

1 participant