Skip to content

Conversation

@konstin
Copy link
Member

@konstin konstin commented Jun 23, 2025

When I started maturin, I chose the https://keepachangelog.com style for the project changelog, and would edit the changelog manually. I now want to change this to automated changelog generation and a slightly improved style.

This PR adds a git cliff config that can generate the changelog based on commits and PR labels. The style is simplified, The version header doesn't have a link anymore, and the PR link is in parentheses behind the description.

It also adds a release guide to the contributing guidelines, with the goal of simplifying the release workflow.

Blocked on orhun/git-cliff#1189

@konstin
Copy link
Member Author

konstin commented Jun 23, 2025

I'm open to using a different tool for this, the main requirements are filtering based on github PR labels and matching the * <message> ([#<PR number>](https://github.com/...)) style (and not requiring conventional commits)

@konstin
Copy link
Member Author

konstin commented Sep 30, 2025

This works now, generating e.g.:

## [unreleased]

- Search_lib_dir: Only recurse into `build*` if it is a directory. ([#2734](https://github.com/pyo3/maturin/pull/2734))
- Add freebsd 14.2 amd64 sysconfig ([#2741](https://github.com/pyo3/maturin/pull/2741))
- Add `git cliff` config

@konstin konstin marked this pull request as ready for review September 30, 2025 07:25
When I started maturin, I chose the https://keepachangelog.com style for the project changelog, and would edit the changelog manually. I now want to change this to automated changelog generation and a slightly improved style.

This PR adds a [git cliff](https://git-cliff.org/) config that can generate the changelog based on commits and PR labels. The style is simplified, The version header doesn't have a link anymore, and the PR link is in parentheses behind the description.

It also adds a release guide to the contributing guidelines, with the goal of simplifying the release workflow.

Blocked on orhun/git-cliff#1189
@konstin
Copy link
Member Author

konstin commented Jan 4, 2026

We can refine the config over time, but I want to try using this for the next release I make.

@konstin konstin enabled auto-merge (squash) January 4, 2026 20:59
@konstin konstin merged commit 9d8274d into main Jan 4, 2026
45 checks passed
@konstin konstin deleted the konsti/git-cliff branch January 4, 2026 22:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants