mirror of
https://github.com/sharkdp/bat.git
synced 2024-09-29 22:21:29 +02:00
Add refined version of release checklist
This commit is contained in:
parent
20223ad77c
commit
05e4e1f2f2
@ -1,27 +1,60 @@
|
|||||||
Release checklist:
|
# Release checklist
|
||||||
|
|
||||||
- [ ] Check for outdated dependencies (`cargo outdated`)
|
## Dependencies
|
||||||
- [ ] Optional: update dependencies with `cargo update`.
|
|
||||||
See also https://deps.rs/repo/github/sharkdp/bat
|
|
||||||
- [ ] Update syntaxes and themes (`cargo install -f --path .; assets/create.sh`).
|
|
||||||
- [ ] Update README (features, usage, languages, ..).
|
|
||||||
- [ ] Update man page
|
|
||||||
|
|
||||||
|
See this page for a good overview: https://deps.rs/repo/github/sharkdp/bat
|
||||||
|
|
||||||
- [ ] Update version in `Cargo.toml`. Run `cargo build` to update `Cargo.lock`
|
- [ ] Optional: update dependencies with `cargo update`. This is also done
|
||||||
- [ ] Update version in README and possibly update minimum Rust version
|
by dependabot, so it is not strictly necessary.
|
||||||
- [ ] Run `cargo fmt`
|
- [ ] Check for outdated dependencies (`cargo outdated`) and decide for each
|
||||||
- [ ] Run `cargo test`
|
of them whether we want to (manually) upgrade. This will require changes
|
||||||
- [ ] Run `cargo install --path . -f`
|
to `Cargo.toml`.
|
||||||
- [ ] Test new features & command-line options
|
|
||||||
- [ ] Check `-h` and `--help` texts
|
|
||||||
|
|
||||||
|
## Version bump
|
||||||
|
|
||||||
- [ ] `cargo publish --dry-run --allow-dirty`.
|
- [ ] Update version in `Cargo.toml`. Run `cargo build` to update `Cargo.lock`.
|
||||||
- [ ] write GitHub release notes
|
Make sure to `git add` the `Cargo.lock` changes as well.
|
||||||
- [ ] check if CI succeeds
|
- [ ] Find the current min. supported Rust version by running
|
||||||
- [ ] `git tag vX.Y.Z; git push --tags`
|
`grep '^\s*MIN_SUPPORTED_RUST_VERSION' .github/workflows/CICD.yml`.
|
||||||
- [ ] check binaries (that were uploaded via Travis/AppVeyor)
|
- [ ] Update the version and the min. supported Rust version in `README.md` and
|
||||||
- [ ] publish to crates.io by cloning a fresh repo and calling `cargo publish`.
|
`doc/README-*.md`.
|
||||||
- [ ] Inform package maintainers about the update:
|
- [ ] Update `CHANGELOG.md`. Introduce a section for the new release and prepare
|
||||||
|
a new (empty) "unreleased" section at the top.
|
||||||
|
|
||||||
|
## Update syntaxes and themes (build assets)
|
||||||
|
|
||||||
|
- [ ] Install the latest master version (`cargo install -f --path .`) and make
|
||||||
|
sure that it is available on the `PATH` (`bat --version` should show the
|
||||||
|
new version).
|
||||||
|
- [ ] Run `assets/create.sh` and check in the binary asset files.
|
||||||
|
|
||||||
|
## Documentation
|
||||||
|
|
||||||
|
- [ ] Review the `-h` and `--help` texts
|
||||||
|
- [ ] Review the `man` page
|
||||||
|
|
||||||
|
## Pre-release checks
|
||||||
|
|
||||||
|
- [ ] Push all changes and wait for CI to succeed (before continuing with the next
|
||||||
|
section).
|
||||||
|
- [ ] Optional: manually test the new features and command-line options. To do this,
|
||||||
|
install the latest `bat` version again (to include the new syntaxes/themes).
|
||||||
|
- [ ] Run `cargo publish --dry-run --allow-dirty` to make sure that it will succeed
|
||||||
|
later (after creating the GitHub release).
|
||||||
|
|
||||||
|
## Release
|
||||||
|
|
||||||
|
- [ ] Create a tag and push it to the remote `git tag vX.Y.Z; git push --tags`.
|
||||||
|
This will trigger the deployment via GitHub Actions.
|
||||||
|
- [ ] Create a new release on GitHub: https://github.com/sharkdp/bat/releases/new
|
||||||
|
Select the new tag and also use it as the release title. Copy the
|
||||||
|
corresponding section from `CHANGELOG.md` and possibly add remarks for
|
||||||
|
package maintainers. Publish the release.
|
||||||
|
- [ ] Check if the binary deployment works (archives and Debian packages should
|
||||||
|
appear when the CI run for the Git tag has finished).
|
||||||
|
- [ ] Publish to crates.io by cloning *a fresh repository* and calling `cargo publish`.
|
||||||
|
|
||||||
|
## Post release
|
||||||
|
|
||||||
|
- [ ] Optional: inform package maintainers about the update:
|
||||||
- https://www.archlinux.org/packages/community/x86_64/bat/
|
- https://www.archlinux.org/packages/community/x86_64/bat/
|
||||||
|
Loading…
Reference in New Issue
Block a user