Mirrors/bevy
2
0
Fork 0
mirror of https://github.com/bevyengine/bevy synced 2024-11-22 12:43:34 +00:00
Code Issues Projects Releases Packages Wiki Activity
bevy/docs/release_checklist.md

88 lines
3.4 KiB
Markdown
Raw Normal View History

Release Checklist (#1834) To help make the process easier and more fool-proof, aid delegation and document institutional knowledge. I'm not entirely sure where this belongs.
2021-04-08 21:33:46 +00:00
# Release Checklist
document how to publish patches (#12879) # Objective - Ensure patches can be released by anyone (with the appropriate permissions) ## Solution - Document the process
2024-04-04 21:18:00 +00:00
## Minor Version
### Minor Pre-release
Bump Bevy to 0.7.0-dev (#4230) # Objective - The [dev docs](https://dev-docs.bevyengine.org/bevy/index.html#) show version 0.6.0, which is actively misleading. [Image of the problem](https://cdn.discordapp.com/attachments/695741366520512563/953513612943704114/Screenshot_20220316-154100_Firefox-01.jpeg) Noticed by @ickk, fix proposed by @mockersf. ## Solution - Bump the version across all Bevy crates to 0.7.0 dev. - Set a reminder in the Release Checklist to remember to do this each release.
2022-03-19 03:54:15 +00:00
Release Checklist (#1834) To help make the process easier and more fool-proof, aid delegation and document institutional knowledge. I'm not entirely sure where this belongs.
2021-04-08 21:33:46 +00:00
1. Check regressions tag.
document how to publish patches (#12879) # Objective - Ensure patches can be released by anyone (with the appropriate permissions) ## Solution - Document the process
2024-04-04 21:18:00 +00:00
2. Check appropriate milestone, and close it.
Release Checklist (#1834) To help make the process easier and more fool-proof, aid delegation and document institutional knowledge. I'm not entirely sure where this belongs.
2021-04-08 21:33:46 +00:00
3. Check GitHub Projects page for staleness.
4. Update change log.
5. Create migration guide.
6. Write blog post.
7. Update book.
Fix release workflow (#4903) # Objective While playing with the code, I found some problems in the recently merged version-bumping workflow: - Most importantly, now that we are using `0.8.0-dev` in development, the workflow will try to bump it to `0.9.0` :sob: - The crate filter is outdated now that we have more crates in `tools`. - We are using `bevy@users.noreply.github.com`, but according to [Github help](https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-your-commit-email-address#about-commit-email-addresses), that email address means "old no-reply email format for the user `bevy`". It is currently not associated with any account, but I feel this is still not appropriate here. ## Solution - Create a new workflow, `Post-release version bump`, that should be run after a release and bumps version from `0.X.0` to `0.X+1.0-dev`. Unfortunately, cargo-release doesn't have a builtin way to do this, so we need to parse and increment the version manually. - Add the new crates in `tools` to exclusion list. Also removes the dependency version specifier from `bevy_ecs_compile_fail_tests`. It is not in the workspace so the dependency version will not get automatically updated by cargo-release. - Change the author email to `41898282+github-actions[bot]@users.noreply.github.com`. According to the discussion [here](https://github.com/actions/checkout/issues/13#issuecomment-724415212) and [here](https://github.community/t/github-actions-bot-email-address/17204/6), this is the email address associated with the github-actions bot account. - Also add the workflows to our release checklist. See infmagic2047#5 and infmagic2047#6 for examples of release and post-release PRs.
2022-06-06 15:47:51 +00:00
8. Bump version number for all crates, using the "Release" workflow.
document how to publish patches (#12879) # Objective - Ensure patches can be released by anyone (with the appropriate permissions) ## Solution - Document the process
2024-04-04 21:18:00 +00:00
* Change the commit message to be nicer
Bump Bevy to 0.7.0-dev (#4230) # Objective - The [dev docs](https://dev-docs.bevyengine.org/bevy/index.html#) show version 0.6.0, which is actively misleading. [Image of the problem](https://cdn.discordapp.com/attachments/695741366520512563/953513612943704114/Screenshot_20220316-154100_Firefox-01.jpeg) Noticed by @ickk, fix proposed by @mockersf. ## Solution - Bump the version across all Bevy crates to 0.7.0 dev. - Set a reminder in the Release Checklist to remember to do this each release.
2022-03-19 03:54:15 +00:00
9. Create tag on GitHub.
document how to publish patches (#12879) # Objective - Ensure patches can be released by anyone (with the appropriate permissions) ## Solution - Document the process
2024-04-04 21:18:00 +00:00
10. Edit Github Release. Add links to the `Release announcement` and `Migration Guide`.
Add a release step, add links to the github release note (#12041) # Objective Add a release step to add the links `Release anouncement` and `Migration guide` to the GitHub release note. - https://github.com/bevyengine/bevy/issues/12011#issuecomment-1955342378
2024-02-23 18:36:07 +00:00
11. Bump `latest` tag to most recent release.
12. Run this workflow to update screenshots:
Add "update screenshots" to release checklist (#10369)
2023-11-04 18:43:15 +00:00
* <https://github.com/bevyengine/bevy-website/actions/workflows/update-screenshots.yml>
* _This will block blog post releases (and take ~40 minutes) so do it early_.
document how to publish patches (#12879) # Objective - Ensure patches can be released by anyone (with the appropriate permissions) ## Solution - Document the process
2024-04-04 21:18:00 +00:00
13. Run this workflow to update wasm examples:
* <https://github.com/bevyengine/bevy-website/actions/workflows/build-wasm-examples.yml>
Bump Bevy to 0.7.0-dev (#4230) # Objective - The [dev docs](https://dev-docs.bevyengine.org/bevy/index.html#) show version 0.6.0, which is actively misleading. [Image of the problem](https://cdn.discordapp.com/attachments/695741366520512563/953513612943704114/Screenshot_20220316-154100_Firefox-01.jpeg) Noticed by @ickk, fix proposed by @mockersf. ## Solution - Bump the version across all Bevy crates to 0.7.0 dev. - Set a reminder in the Release Checklist to remember to do this each release.
2022-03-19 03:54:15 +00:00
document how to publish patches (#12879) # Objective - Ensure patches can be released by anyone (with the appropriate permissions) ## Solution - Document the process
2024-04-04 21:18:00 +00:00
### Minor Release
Bump Bevy to 0.7.0-dev (#4230) # Objective - The [dev docs](https://dev-docs.bevyengine.org/bevy/index.html#) show version 0.6.0, which is actively misleading. [Image of the problem](https://cdn.discordapp.com/attachments/695741366520512563/953513612943704114/Screenshot_20220316-154100_Firefox-01.jpeg) Noticed by @ickk, fix proposed by @mockersf. ## Solution - Bump the version across all Bevy crates to 0.7.0 dev. - Set a reminder in the Release Checklist to remember to do this each release.
2022-03-19 03:54:15 +00:00
1. Release on crates.io
document how to publish patches (#12879) # Objective - Ensure patches can be released by anyone (with the appropriate permissions) ## Solution - Document the process
2024-04-04 21:18:00 +00:00
* `bash tools/publish.sh`
Bump Bevy to 0.7.0-dev (#4230) # Objective - The [dev docs](https://dev-docs.bevyengine.org/bevy/index.html#) show version 0.6.0, which is actively misleading. [Image of the problem](https://cdn.discordapp.com/attachments/695741366520512563/953513612943704114/Screenshot_20220316-154100_Firefox-01.jpeg) Noticed by @ickk, fix proposed by @mockersf. ## Solution - Bump the version across all Bevy crates to 0.7.0 dev. - Set a reminder in the Release Checklist to remember to do this each release.
2022-03-19 03:54:15 +00:00
2. Announce on:
Release Checklist (#1834) To help make the process easier and more fool-proof, aid delegation and document institutional knowledge. I'm not entirely sure where this belongs.
2021-04-08 21:33:46 +00:00
1. HackerNews
2. Twitter
3. Reddit: /r/bevy, /r/rust, /r/rust_gamedev
4. Discord: Bevy, Game Development in Rust, Rust Programming Language Community
5. This Month in Rust Game Development newsletter
6. This Week in Rust newsletter
Bump Bevy to 0.7.0-dev (#4230) # Objective - The [dev docs](https://dev-docs.bevyengine.org/bevy/index.html#) show version 0.6.0, which is actively misleading. [Image of the problem](https://cdn.discordapp.com/attachments/695741366520512563/953513612943704114/Screenshot_20220316-154100_Firefox-01.jpeg) Noticed by @ickk, fix proposed by @mockersf. ## Solution - Bump the version across all Bevy crates to 0.7.0 dev. - Set a reminder in the Release Checklist to remember to do this each release.
2022-03-19 03:54:15 +00:00
document how to publish patches (#12879) # Objective - Ensure patches can be released by anyone (with the appropriate permissions) ## Solution - Document the process
2024-04-04 21:18:00 +00:00
### Minor Post-release
Bump Bevy to 0.7.0-dev (#4230) # Objective - The [dev docs](https://dev-docs.bevyengine.org/bevy/index.html#) show version 0.6.0, which is actively misleading. [Image of the problem](https://cdn.discordapp.com/attachments/695741366520512563/953513612943704114/Screenshot_20220316-154100_Firefox-01.jpeg) Noticed by @ickk, fix proposed by @mockersf. ## Solution - Bump the version across all Bevy crates to 0.7.0 dev. - Set a reminder in the Release Checklist to remember to do this each release.
2022-03-19 03:54:15 +00:00
Fix release workflow (#4903) # Objective While playing with the code, I found some problems in the recently merged version-bumping workflow: - Most importantly, now that we are using `0.8.0-dev` in development, the workflow will try to bump it to `0.9.0` :sob: - The crate filter is outdated now that we have more crates in `tools`. - We are using `bevy@users.noreply.github.com`, but according to [Github help](https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-your-commit-email-address#about-commit-email-addresses), that email address means "old no-reply email format for the user `bevy`". It is currently not associated with any account, but I feel this is still not appropriate here. ## Solution - Create a new workflow, `Post-release version bump`, that should be run after a release and bumps version from `0.X.0` to `0.X+1.0-dev`. Unfortunately, cargo-release doesn't have a builtin way to do this, so we need to parse and increment the version manually. - Add the new crates in `tools` to exclusion list. Also removes the dependency version specifier from `bevy_ecs_compile_fail_tests`. It is not in the workspace so the dependency version will not get automatically updated by cargo-release. - Change the author email to `41898282+github-actions[bot]@users.noreply.github.com`. According to the discussion [here](https://github.com/actions/checkout/issues/13#issuecomment-724415212) and [here](https://github.community/t/github-actions-bot-email-address/17204/6), this is the email address associated with the github-actions bot account. - Also add the workflows to our release checklist. See infmagic2047#5 and infmagic2047#6 for examples of release and post-release PRs.
2022-06-06 15:47:51 +00:00
1. Bump version number for all crates to next versions, as `0.X-dev`, using the "Post-release version bump" workflow, to ensure properly displayed version for [Dev Docs](https://dev-docs.bevyengine.org/bevy/index.html).
Bump Bevy to 0.7.0-dev (#4230) # Objective - The [dev docs](https://dev-docs.bevyengine.org/bevy/index.html#) show version 0.6.0, which is actively misleading. [Image of the problem](https://cdn.discordapp.com/attachments/695741366520512563/953513612943704114/Screenshot_20220316-154100_Firefox-01.jpeg) Noticed by @ickk, fix proposed by @mockersf. ## Solution - Bump the version across all Bevy crates to 0.7.0 dev. - Set a reminder in the Release Checklist to remember to do this each release.
2022-03-19 03:54:15 +00:00
2. Update Bevy version used for Bevy book code validation to latest release.
document how to publish patches (#12879) # Objective - Ensure patches can be released by anyone (with the appropriate permissions) ## Solution - Document the process
2024-04-04 21:18:00 +00:00
## Patch
### Patch Pre-release
1. Check appropriate milestone.
2. Close the milestone, open the next one if anything remains and transfer them.
3. Bump version number for all crates, using the command from the "Release" workflow locally, with `patch` for the new version. At the time of writing this:
* `cargo release patch --workspace --no-publish --execute --no-tag --no-confirm --no-push --dependent-version upgrade --exclude ci --exclude errors --exclude bevy_mobile_example --exclude build-wasm-example`
* Change the commit message to be nicer
4. Create tag on GitHub.
5. Edit Github Release. Add link to the comparison between this patch and the previous version.
6. Bump `latest` tag to most recent release.
7. Run this workflow to update screenshots:
* <https://github.com/bevyengine/bevy-website/actions/workflows/update-screenshots.yml>
8. Run this workflow to update wasm examples:
* <https://github.com/bevyengine/bevy-website/actions/workflows/build-wasm-examples.yml>
### Patch Release
1. Release on crates.io
* `bash tools/publish.sh`
2. Announce on:
1. Discord: Bevy
### Patch Post-Release
Document the Release Candidate process (#13718) # Objective - Document how to release a RC ## Solution - Also allow CI to trigger on release branches
2024-06-07 01:56:25 +00:00
## Release Candidate
### RC Pre-Release
1. Check appropriate milestone.
2. Create a branch for the release.
3. Bump version number for all crates, using the command from the "Release" workflow locally, with `rc` for the new version. At the time of writing this:
* `cargo release rc --workspace --no-publish --execute --no-tag --no-confirm --no-push --dependent-version upgrade --exclude ci --exclude errors --exclude bevy_mobile_example --exclude build-wasm-example`
* Change the commit message to be nicer
4. Create tag on GitHub.
5. Edit Github Release. Add link to the comparison between this rc and the previous version.
### RC Release
1. Release on crates.io
* `bash tools/publish.sh`
2. Announce on:
1. Discord: Bevy, #dev-announcements
### RC Post-Release
Reference in a new issue Copy permalink