Update release-checklist.md (#128)
This commit is contained in:
@@ -1,27 +1,47 @@
|
||||
---
|
||||
name: Release checklist
|
||||
about: This is a checklist to be used when doing a new release
|
||||
title: New release checklist for [version number]
|
||||
about: This is a checklist for maintainers to be used when creating a new release.
|
||||
title: New release checklist for [version number] (maintainers only).
|
||||
labels: ''
|
||||
assignees: ''
|
||||
|
||||
---
|
||||
|
||||
You can see the action released in [here](https://github.com/marketplace/actions/sentry-release).
|
||||
You can see the action released in [here](https://github.com/marketplace/actions/sentry-release). The version shows what was the last released version.
|
||||
|
||||
Checklist for a new release:
|
||||
|
||||
- [ ] Create a PR that bumps the version in `package.json` and merge it
|
||||
- [ ] Read notes below to figure out which version to pick
|
||||
- [ ] Make the commit read "Bump version to x.y.z"
|
||||
- [ ] Once merged, visit the [releases page](https://github.com/getsentry/action-release/releases)
|
||||
- [ ] Create a new release
|
||||
- [ ] Name the release (You can use the version number if you want)
|
||||
- [ ] Describe the release by looking at what commits landed on master since the last release
|
||||
- Create a new tag by entering it in the drop down
|
||||
- [ ] If it's a security update, tag is a patch release
|
||||
- [ ] If it's just some improvements or bug fix, tag is a minor release
|
||||
- [ ] If there are _breaking_ changes, tag it as a major release
|
||||
- [ ] Figure out if we need to do an external annoucement of sorts
|
||||
- [ ] Click Draft a new release
|
||||
- [ ] Create a new tag by entering it in the drop down (see screenshot)
|
||||
- [ ] Name the release (Use the version number if you want)
|
||||
- [ ] Describe the release
|
||||
- [ ] Use the button Generate Release Notes (see screenshot)
|
||||
- [ ] Update the Full Changelog link to use the right tags (there's a minor bug)
|
||||
- The first value is the last release; the second value is the tag that has not yet been created, thus, the link won't be working yet
|
||||
- [ ] Once published, visit [the marketplace](https://github.com/marketplace/actions/sentry-release) to see that the release is showing up
|
||||
- Update existing major tag (i.e. v1, v2 etc)
|
||||
- [ ] Run `git tag -f v<Major Release Num>`
|
||||
- [ ] Run `git push origin master --tags -f`
|
||||
- [ ] Update existing major tag (i.e. v1, v2 etc); Run the following commands
|
||||
- [ ] `git checkout master && git pull`
|
||||
- [ ] `git tag -f v<Major Release Num>`
|
||||
- [ ] `git push origin master --tags -f`
|
||||
|
||||
**DONE!!** 🎉
|
||||
|
||||
<hr/>
|
||||
|
||||
Screenshot of UI to create tag as part of the release:
|
||||
|
||||
<img width="317" alt="image" src="https://user-images.githubusercontent.com/44410/221204718-6fc7b2d8-a8a1-4c13-a626-0fdebff11892.png">
|
||||
|
||||
Screenshot of UI to generate release notes:
|
||||
|
||||
<img width="250" alt="image" src="https://user-images.githubusercontent.com/44410/221206306-bba4a62d-2181-4cad-9285-2aa1a7bde5e8.png">
|
||||
|
||||
### NOTES
|
||||
|
||||
We use semver (x.y.z) versioning. This basically means:
|
||||
* x bump (breaking compatibility)
|
||||
* z bump (bug fix/security)
|
||||
* y bump for everything that does not fall on the other two categories
|
||||
|
||||
Reference in New Issue
Block a user