Skip to content

Commit 200297c

Browse files
docs: fix release template
1 parent aef7c4a commit 200297c

1 file changed

Lines changed: 24 additions & 23 deletions

File tree

.github/ISSUE_TEMPLATE/release.md

Lines changed: 24 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -8,58 +8,59 @@ assignees: ""
88

99
## Part 1: Bump BDK Rust Version
1010

11-
1. - [ ] Open a PR with an update to `Cargo.toml` to the new bdk release candidate and ensure all CI workflows run correctly. Fix errors if necessary.
12-
2. - [ ] Once the new bdk release is out, update the PR to replace the release candidate with the full release and merge.
11+
- [ ] Open a PR with an update to `Cargo.toml` to the new bdk release candidate and ensure all CI workflows run correctly. Fix errors if necessary.
12+
- [ ] Once the new bdk release is out, update the PR to replace the release candidate with the full release and merge.
1313

1414
## Part 2: Prepare Libraries for Release Branch
1515

1616
### _Android_
1717

18-
3. - [ ] Delete the `target` directory in bdk-ffi and all `build` directories (in root and `lib`) in the bdk-android directory to make sure you're building the library from scratch.
19-
4. - [ ] Build the library and run the offline and live tests, and adjust them if necessary (note that you'll need an Android emulator running).
18+
- [ ] Delete the `target` directory in bdk-ffi and all `build` directories (in root and `lib`) in the bdk-android directory to make sure you're building the library from scratch.
19+
- [ ] Build the library and run the offline and live tests, and adjust them if necessary (note that you'll need an Android emulator running).
2020
```shell
2121
# start an emulator prior to running the tests
2222
cd ./bdk-android/
2323
just clean
2424
just build
2525
just test
2626
```
27-
5. - [ ] Update the readme if necessary.
27+
- [ ] Update the readme if necessary.
2828

2929
### _Swift_
3030

31-
6. - [ ] Delete the `target` directory in bdk-ffi.
32-
7. - [ ] Run all offline and live tests and adjust them if necessary.
31+
- [ ] Delete the `target` directory in bdk-ffi.
32+
- [ ] Run all offline and live tests and adjust them if necessary.
3333
```shell
3434
cd ./bdk-swift/
3535
just clean
3636
just build
3737
just test
3838
```
39-
8. - [ ] Update the readme if necessary.
39+
- [ ] Update the readme if necessary.
4040

4141
## Part 3: Release Workflow
4242

43-
9. - [ ] Update the Android and Swift libraries as per the _Part 2_ section above. Open a single PR on `master` for all of these changes called `Prepare language bindings libraries for 0.X release`. See [example PR here](https://github.com/bitcoindevkit/bdk-ffi/pull/315).
44-
10. - [ ] Create a new branch off of `master` called `release/<feature version>`, e.g. `release/1.2`
45-
11. - [ ] Generate release notes with GitHub's built-in release note generator, using the previous release tag as the previous tag and the release branch as the target. Review the generated notes and prepare the final changelog text on the side in a text editor.
46-
12. - [ ] Update the bdk-android version from a `SNAPSHOT` version to a release version (`2.4.0-SNAPSHOT` -> `2.4.0`), update the Rust library version in `Cargo.toml` from an alpha to a release version (`2.4.0-alpha.0` -> `2.4.0`), add the reviewed release notes to the changelog file, and open a PR to the release branch with these changes.
47-
13. - [ ] Get a review and ACK and merge this PR on the release branch.
48-
14. - [ ] Create the tag for the release and make sure to add the reviewed changelog info to the tag. Push the tag to GitHub.
43+
- [ ] Update the Android and Swift libraries as per the _Part 2_ section above. Open a single PR on `master` for all of these changes called `Prepare language bindings libraries for 0.X release`. See [example PR here](https://github.com/bitcoindevkit/bdk-ffi/pull/315).
44+
- [ ] Create a new branch off of `master` called `release/<feature version>`, e.g. `release/1.2`
45+
- [ ] Generate release notes with GitHub's built-in release note generator, using the previous release tag as the previous tag and the release branch as the target. Review the generated notes and prepare the final changelog text on the side in a text editor.
46+
- [ ] Update the bdk-android version from a `SNAPSHOT` version to a release version (`2.4.0-SNAPSHOT` -> `2.4.0`), update the Rust library version in `Cargo.toml` from an alpha to a release version (`2.4.0-alpha.0` -> `2.4.0`), add the reviewed release notes to the changelog file, and open a PR to the release branch with these changes.
47+
- [ ] Get a review and ACK and merge this PR on the release branch.
48+
- [ ] Create the tag for the release and make sure to add the reviewed changelog info to the tag. Push the tag to GitHub.
4949
```shell
5050
git tag v0.6.0 --sign --edit
5151
git push upstream v0.6.0
5252
```
53-
15. - [ ] Trigger manual releases for both libraries (for Swift, go to the [bdk-swift](https://github.com/bitcoindevkit/bdk-swift) repository and trigger the workflow using `master`. Simply add the version number and tag name in the text fields when running the workflow manually. Note that the version number must not contain the `v`, i.e. `0.26.0`, but the tag will have it, i.e. `v0.26.0`). For Android, trigger the release workflow using the tag (not a branch).
54-
16. - [ ] Make sure the released libraries work and contain the artifacts you would expect.
55-
17. - [ ] Build the Rust API docs and publish them to the repo's GitHub Pages.
53+
- [ ] Update all downstream libraries (dart, rn, python, and jvm) to the given tag. This allows for everyone to test their own workflows, run their CI, etc.
54+
- [ ] Trigger releases for both libraries (for Swift, go to the [bdk-swift](https://github.com/bitcoindevkit/bdk-swift) repository and trigger the workflow using `master`. Simply add the version number and tag name in the text fields when running the workflow manually. Note that the version number must not contain the `v`, i.e. `0.26.0`, but the tag will have it, i.e. `v0.26.0`). For Android, trigger the release locally.
55+
- [ ] Make sure the released libraries work and contain the artifacts you would expect.
56+
- [ ] Build the Rust API docs and publish them to the repo's GitHub Pages.
5657
```shell
5758
cd bdk-ffi/
5859
just docs
5960
```
60-
18. - [ ] Bump the version on master from `1.1.0-SNAPSHOT` to `1.2.0-SNAPSHOT` (Android) and `1.1.0-alpha.0` to `1.2.0-alpha.0` (Rust).
61-
19. - [ ] Apply changes to the release issue template if needed.
62-
20. - [ ] Make release on GitHub using the reviewed release notes.
63-
21. - [ ] Build API docs for Android locally and PR the website to the bitcoindevkit.org repo.
64-
22. - [ ] Post in the announcement channel.
65-
23. - [ ] Tweet about the new release!
61+
- [ ] Bump the version on master from `1.1.0-SNAPSHOT` to `1.2.0-SNAPSHOT` (Android) and `1.1.0-alpha.0` to `1.2.0-alpha.0` (Rust).
62+
- [ ] Apply changes to the release issue template if needed.
63+
- [ ] Make release on GitHub using the reviewed release notes.
64+
- [ ] Build API docs for Android locally and PR the website to the bitcoindevkit.org repo.
65+
- [ ] Post in the announcement channel.
66+
- [ ] Tweet about the new release!

0 commit comments

Comments
 (0)