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)

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 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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants