Skip to content

Commit

Permalink
docs: update release docs (#1606)
Browse files Browse the repository at this point in the history
- not every release is a prerelease, now, so update version guidance
- add ethportal-api release instructions
- don't rebase local master before tagging release

If you have commits on your local master branch, rebasing would tag them
into the release, bypassing the standard PR process.
  • Loading branch information
carver committed Dec 12, 2024
1 parent d563617 commit c93e129
Showing 1 changed file with 21 additions and 3 deletions.
24 changes: 21 additions & 3 deletions book/src/developers/contributing/releases/release_checklist.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,17 +15,35 @@ anything.

Make sure that version follows [semver](https://semver.org/) rules e.g (`0.2.0-alpha.3`).

**For the time being, ALWAYS specify the `-alpha` suffix.**
Since trin is now stable, but v0, breaking changes are a minor version bump,
and all other changes are a patch version bump. Updating to v1 would require a
group discussion and decision.

## Release the version
## Release dependencies

For now, that's just ethportal-api. Manually bump the version in the
Cargo.toml, and run `cargo update` to update the workspace lockfile. Commit and
merge these changes to trin. Then run:

```bash
cd ethportal-api
cargo publish --no-verify
```

We would like to get rid of the no-verify ASAP, but for now Cargo.lock is
causing issues that we have no other workaround for. `cargo publish` generates
a new lock file, and then complains that the lockfile is new. See this
[StackOverflow post](https://stackoverflow.com/questions/79276315/how-to-build-a-cargo-lock-file-for-a-package-within-a-workspace).

## Release Trin

We use automated github release workflow to create a new release.
This will create a new release draft with the new tag and will build all the binaries and attach them to the release.

1. Checkout and rebase local master to upstream
```bash
git checkout master
git pull --rebase upstream master
git pull --ff-only upstream master
```
2. Create a new git tag with the chosen version, for example:
```bash
Expand Down

0 comments on commit c93e129

Please sign in to comment.