@@ -11,6 +11,7 @@ As a maintainer, you have two options to choose from when cutting a new
1111release: a beta release or an official release.
1212The main difference between the two is that they use different values for
1313the ` RUSTUP_UPDATE_ROOT ` environment variable:
14+
1415- A beta release is deployed on ` https://dev-static.rust-lang.org/rustup ` .
1516- An official release is deployed on ` https://static.rust-lang.org/rustup ` .
1617
@@ -25,14 +26,15 @@ or an official [r]elease:
25261 . [ b/r] In a separate PR:
2627 1 . If the version strings in ` Cargo.toml ` s haven't been updated:
2728 - Decide what the new version number ` $VER_NUM ` should be.
28- > ** Note:** We always increment the * minor* number unless:
29+ > ** Note:** We always increment the _ minor_ number unless:
30+ >
2931 > - A major incompatibility has been introduced in this release:
30- > increment the * major * number instead.
32+ > increment the _ major _ number instead.
3133 > - This release is a hotfix because the last one had a defect:
32- > increment the * patch * number instead.
34+ > increment the _ patch _ number instead.
3335 - Update ` Cargo.toml ` and ` download/Cargo.toml ` to have that same new
3436 version number, then run ` cargo build ` and review ` Cargo.lock ` changes.
35- If all looks well, make a commit.
37+ - If all looks well, make a commit.
3638 2 . Update ` CHANGELOG.md ` accordingly if necessary.
37392 . [ b/r] After merging the PR made in step 1, in a separate PR:
3840 1 . Update ` rustup-init.sh ` so that:
@@ -55,18 +57,22 @@ or an official [r]elease:
5557 for the reported version statements to ensure that
5658 we definitely built something cleanly which reports as the right version
5759 number when run `--version`.
58- 6. [r] Make a new PR to the [Rust Blog] adding a new release announcement post.
59- 7. [b/r] Ping someone in the release team to perform the actual release.
60+ 6. [b] Make a new PR to the [Inside Rust Blog] adding a new "Call for Testing"
61+ announcement post.
62+ 7. [r] Make a new PR to the [Rust Blog] adding a new release announcement post.
63+ 8. [b/r] Ping someone in the release team to perform the actual release.
6064 They can find instructions in `ci/sync-dist.py`.
6165 > **Note:** Some manual testing occurs here, so hopefully they'll catch
62- anything egregious in which case abort the change and roll back.
63- 8. [b] Once the beta release has happened, post a new topic named "Seeking beta
64- testers for Rustup $VER_NUM" on the [Internals Forum].
65- 9. [r] Once the official release has happened, prepare and push a tag on the
66- latest `stable` commit.
67- - `git tag -as $VER_NUM -m $VER_NUM` (optionally without `-s` if not GPG
68- signing the tag)
69- - `git push origin $VER_NUM`
66+ > anything egregious in which case abort the change and roll back.
67+ 9. [b] Once the beta release has happened, post a new topic named "Seeking beta
68+ testers for Rustup $VER_NUM" on the [Internals Forum] to point to the blog
69+ post made previously.
70+ 10. [r] Once the official release has happened, prepare and push a tag on the
71+ latest `stable` commit.
72+ - `git tag -as $VER_NUM -m $VER_NUM` (optionally without `-s` if not GPG
73+ signing the tag)
74+ - `git push origin $VER_NUM`
7075
7176[Rust Blog]: https://github.com/rust-lang/blog.rust-lang.org
77+ [Inside Rust Blog]: https://github.com/rust-lang/blog.rust-lang.org/tree/main/content/inside-rust
7278[Internals Forum]: https://internals.rust-lang.org
0 commit comments