Changelog Update

If you want to help with updating the changelog, you're in the right place.

When to update

The changelog is ideally updated during the week before an upcoming stable release. Typos and other small fixes/additions are always welcome. You can find the release dates on the Rust Forge.

Most of the time we only need to update the changelog for minor Rust releases. It's been very rare that Clippy changes were included in a patch release.

How to update

1. Finding the relevant Clippy commits

Each Rust release ships with its own version of Clippy. The Clippy submodule can be found in the tools directory of the Rust repository.

To find the Clippy commit hash for a specific Rust release you select the Rust release tag from the dropdown and then check the commit of the Clippy directory:

2. Fetching the PRs between those commits

You'll want to run util/fetch_prs_between.sh commit1 commit2 > changes.txt and open that file in your editor of choice.

commit1 is the Clippy commit hash of the previous stable release
commit2 is the Clippy commit hash of the release you want to write the changelog for.

When updating the changelog it's also a good idea to make sure that commit1 is already correct in the current changelog.

3. Authoring the final changelog

The above script should have dumped all the relevant PRs to the file you specified. It should have filtered out most of the irrelevant PRs already, but it's a good idea to do a manual cleanup pass where you look for more irrelevant PRs. If you're not sure about some PRs, just leave them in for the review and ask for feedback.

With PRs filtered, you can start to take each PR and move the changelog: content to CHANGELOG.md. Adapt the wording as you see fit but try to keep it somewhat coherent.

The order should roughly be:

New lints
Changes that expand what code existing lints cover
ICE fixes
False positive fixes
Suggestion fixes/improvements

2.3 KiB Raw Blame History