|
| 1 | +--- |
| 2 | +name: Patch Release |
| 3 | +about: Create a new patch release [for release managers only] |
| 4 | +title: 'Release MAJOR.MINOR.PATCH+1' |
| 5 | +labels: 'release' |
| 6 | +assignees: '' |
| 7 | + |
| 8 | +--- |
| 9 | + |
| 10 | +## Create a new patch release |
| 11 | + |
| 12 | +### Summary |
| 13 | + |
| 14 | +<--release summary to be used in announcements--> |
| 15 | + |
| 16 | +### Commit |
| 17 | + |
| 18 | +<--latest commit ID to include in this release--> |
| 19 | + |
| 20 | +### Changelog |
| 21 | + |
| 22 | +<--add notices from PRs merged since the prior release, see ["keep a changelog"]--> |
| 23 | + |
| 24 | +### Checklist |
| 25 | + |
| 26 | +Release numbering must follow [Semantic Versioning]. These steps assume the current `master` |
| 27 | +branch **development** version is *MAJOR.MINOR.PATCH*. |
| 28 | + |
| 29 | +### On the day of the patch release |
| 30 | + |
| 31 | +Change the `master` branch to the new PATCH+1 version: |
| 32 | + |
| 33 | +- [ ] Switch to the `master` branch. |
| 34 | +- [ ] Create a new PR branch called `bump_dev_MAJOR_MINOR_PATCH+1`, eg. `bump_dev_0_22_1`. |
| 35 | +- [ ] Bump the `bump_dev_MAJOR_MINOR` branch to the next development PATCH+1 version. |
| 36 | + - Change the `Cargo.toml` version value to `MAJOR.MINOR.PATCH+1`. |
| 37 | + - The commit message should be "Bump version to MAJOR.MINOR.PATCH+1". |
| 38 | +- [ ] Create PR and merge the `bump_dev_MAJOR_MINOR_PATCH+1` branch to `master`. |
| 39 | + - Title PR "Bump version to MAJOR.MINOR.PATCH+1". |
| 40 | + |
| 41 | +Cherry-pick, tag and publish new PATCH+1 release: |
| 42 | + |
| 43 | +- [ ] Merge fix PRs to the `master` branch. |
| 44 | +- [ ] Git cherry-pick fix commits to the `release/MAJOR.MINOR` branch to be patched. |
| 45 | +- [ ] Verify fixes in `release/MAJOR.MINOR` branch. |
| 46 | +- [ ] Bump the `release/MAJOR.MINOR.PATCH+1` branch to `MAJOR.MINOR.PATCH+1` version. |
| 47 | + - Change the `Cargo.toml` version value to `MAJOR.MINOR.MINOR.PATCH+1`. |
| 48 | + - The commit message should be "Bump version to MAJOR.MINOR.PATCH+1". |
| 49 | +- [ ] Add a tag to the `HEAD` commit in the `release/MAJOR.MINOR` branch. |
| 50 | + - The tag name should be `vMAJOR.MINOR.PATCH+1` |
| 51 | + - The first line of the tag message should be "Release MAJOR.MINOR.PATCH+1". |
| 52 | + - In the body of the tag message put a copy of the **Summary** and **Changelog** for the release. |
| 53 | + - Make sure the tag is signed, for extra safety use the explicit `--sign` flag. |
| 54 | +- [ ] Wait for the CI to finish one last time. |
| 55 | +- [ ] Push the new tag to the `bitcoindevkit/bdk_rpc_client` repo. |
| 56 | +- [ ] Publish **all** the updated crates to crates.io. |
| 57 | +- [ ] Create the release on GitHub. |
| 58 | + - Go to "tags", click on the dots on the right and select "Create Release". |
| 59 | + - Set the title to `Release MAJOR.MINOR.PATCH+1`. |
| 60 | + - In the release notes body put the **Summary** and **Changelog**. |
| 61 | + - Use the "+ Auto-generate release notes" button to add details from included PRs. |
| 62 | + - Until we reach a `1.0.0` release check the "Pre-release" box. |
| 63 | +- [ ] Make sure the new release shows up on [crates.io] and that the docs are built correctly on [docs.rs]. |
| 64 | +- [ ] Announce the release, using the **Summary**, on Discord, Twitter and Mastodon. |
| 65 | +- [ ] Celebrate 🎉 |
| 66 | + |
| 67 | +[Semantic Versioning]: https://semver.org/ |
| 68 | +[crates.io]: https://crates.io/crates/bdk_rpc_client |
| 69 | +[docs.rs]: https://docs.rs/bdk_rpc_client/latest/bdk_rpc_client |
| 70 | +["keep a changelog"]: https://keepachangelog.com/en/1.0.0/ |
0 commit comments