|
1 | 1 | # Cutting a Jaeger UI release |
2 | 2 |
|
3 | | -1. Determine the version for the release. |
4 | | - - Follow [semver.org](https://semver.org) to determine the new version for Jaeger UI. |
5 | | - - Review all changes since the last release to determine how, if at all, any externally facing APIs are impacted. This includes, but is not limited to, the UI config and URL routes such as deep-linking and configuring the embedded mode. |
6 | | - - Preface the version with a "v", e.g. `v1.0.0`. |
7 | | -1. Create and merge, per approval, a PR which preps the release. |
| 3 | +1. Create and merge, per approval, a PR which preps the release ([example](https://github.com/jaegertracing/jaeger-ui/pull/1767)). |
8 | 4 | 1. The PR title should match the format "Prepare release vX.Y.Z". |
9 | | - 1. CHANGELOG.md |
10 | | - - Change the version of the current release from "Next (unreleased)" to "vX.Y.Z (Month D, YYYY)" where "vX.Y.Z" is the semver for this release. |
11 | | - - Make sure all relevant changes made since the last release are present and listed under the current release. |
12 | | - - Tip: Run `node scripts/get-changelog.js` script that prints a dozen most recent commits in the chagelog format. |
| 5 | + 2. CHANGELOG.md |
| 6 | + - Change the version of the current release from "Next (unreleased)" to "vX.Y.Z (Month D, YYYY)" where "vX.Y.Z" is the [semver](https://semver.org) for this release. |
| 7 | + - Run `make changelog` to list all changes since the last release. |
| 8 | + - Review all changes to determine how, if at all, any externally facing APIs are impacted. This includes, but is not limited to, the UI config and URL routes such as deep-linking and configuring the embedded mode. |
13 | 9 | - If necessary, add a note detailing any impact to externally facing APIs. |
14 | | - 1. Update `packages/jaeger-ui/package.json#version` to refer to the version being released. |
15 | | -1. Create a GitHub release. |
| 10 | + 3. Update `packages/jaeger-ui/package.json#version` to refer to the version being released. |
| 11 | +2. Create a GitHub release. |
16 | 12 | - Automated (requires [gh](https://cli.github.com/manual/installation)): |
17 | | - - `python ./scripts/draft-release.py` |
| 13 | + - `make draft-release` |
18 | 14 | - Manual: |
19 | 15 | - The tag and release must refer to the commit created when the PR from the previous step was merged. |
20 | 16 | - The tag name for the GitHub release should be the version for the release. It should include the "v", e.g. `v1.0.0`. |
|
0 commit comments