From 4bad65b5b177049f856248537bd09548ad9d3eec Mon Sep 17 00:00:00 2001 From: garrytan Date: Thu, 29 Oct 2026 06:02:05 +0000 Subject: [PATCH] docs(ship-policy): rollback lands open fragment PRs first; restamp folds only with the key on Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> --- docs/ship-policy.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/ship-policy.md b/docs/ship-policy.md index 8f255beb0..e86a89935 100644 --- a/docs/ship-policy.md +++ b/docs/ship-policy.md @@ -1271,8 +1271,10 @@ release-field-only conflict, write an entry from the title, or refuse on a product conflict. Then set `changelog_fragments` and `min_gstack_version` in one policy PR; a claim-at-open repository switches `queue_mode` to `stamp-at-merge` in the same PR. Open PRs need no change: `land` handles each -census case. Rollback is removing the key; `gstack-restamp` still folds any -fragment it finds, so no entry is lost. +census case. Rollback is removing the key. With it off, `gstack-restamp` +neither folds nor deletes fragment files, so first land every open PR that +carries a fragment (`land --census` lists them) or move each fragment's text +under `[Unreleased]` in its PR; otherwise that entry never reaches CHANGELOG.md. ## The tree receipt