From 4bd4d22589b8be078340214e1888ea762d4c7c32 Mon Sep 17 00:00:00 2001 From: Jeff Martin Date: Fri, 31 Jul 2026 12:05:28 -0500 Subject: [PATCH 1/2] Releasing: document RC preview and failed publish recovery --- RELEASING.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/RELEASING.md b/RELEASING.md index b89910a..0a33cfc 100644 --- a/RELEASING.md +++ b/RELEASING.md @@ -14,7 +14,13 @@ Then cut it: script/release patch ``` -To cut a release candidate instead: +To preview a release candidate: + +```sh +RELEASE_DRY_RUN=1 script/release patch --rc +``` + +Then cut it: ```sh script/release patch --rc @@ -23,6 +29,10 @@ script/release patch --rc The first candidate is `vX.Y.Z-rc.1`; repeating the same bump increments `rc.N`. Run the bump without `--rc` to publish the stable `vX.Y.Z`. +Pushed release tags are immutable. If publishing fails, fix the publisher and +run the release script again for the next RC; do not move or reuse the failed +tag. + Use `patch` for compatible fixes, `minor` for compatible additions, and `major` for breaking changes. From 3aefc72942f0418cca6b59566a90e58afe02c646 Mon Sep 17 00:00:00 2001 From: Jeff Martin Date: Fri, 31 Jul 2026 12:07:08 -0500 Subject: [PATCH 2/2] Releasing: align failed publish recovery wording --- RELEASING.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/RELEASING.md b/RELEASING.md index 0a33cfc..52ee89d 100644 --- a/RELEASING.md +++ b/RELEASING.md @@ -29,9 +29,8 @@ script/release patch --rc The first candidate is `vX.Y.Z-rc.1`; repeating the same bump increments `rc.N`. Run the bump without `--rc` to publish the stable `vX.Y.Z`. -Pushed release tags are immutable. If publishing fails, fix the publisher and -run the release script again for the next RC; do not move or reuse the failed -tag. +A pushed release tag is immutable. If publishing fails, fix the publisher and +run the release script again for the next RC; do not move or reuse the failed tag. Use `patch` for compatible fixes, `minor` for compatible additions, and `major` for breaking changes.