docs(readme): reconcile publish_mode:immediate default vs 'human-gated every release' claim #332

Closed
opened 2026-07-03 13:35:59 +02:00 by bosun · 0 comments
Owner

Finding

README claims: "Gates every release behind a human. ... you click Publish"

Quick-start example + reusable workflow default to publish_mode: immediate. Under default, merging prep PR publishes release directly — no Publish click.

Blocking rationale

Advertising safety property that doesn't hold by default is v1.0.0 blocker. Adopters may select tool specifically for the extra gate.

Fix

Option A (recommended): change default to publish_mode: draft.
Option B: rewrite README to accurately describe current default + how to enable draft mode.
Option C: default draft in reusable, keep immediate in quick-start with tradeoff note.

Anchor

External correctness cold-read (anonymous ChatGPT session, uploaded to operator 2026-07-03). Full review surfaced 10 findings across 5 blocking-v1.0.0 + 2 should-fix pre-v1.0.0 + 3 post-v1.0.0 backlog. This tracker addresses one of them.

BLOCKING v1.0.0.

## Finding README claims: "Gates every release behind a human. ... you click Publish" Quick-start example + reusable workflow default to `publish_mode: immediate`. Under default, merging prep PR publishes release directly — no Publish click. ## Blocking rationale Advertising safety property that doesn't hold by default is v1.0.0 blocker. Adopters may select tool specifically for the extra gate. ## Fix Option A (recommended): change default to `publish_mode: draft`. Option B: rewrite README to accurately describe current default + how to enable draft mode. Option C: default draft in reusable, keep immediate in quick-start with tradeoff note. ## Anchor External correctness cold-read (anonymous ChatGPT session, uploaded to operator 2026-07-03). Full review surfaced 10 findings across 5 blocking-v1.0.0 + 2 should-fix pre-v1.0.0 + 3 post-v1.0.0 backlog. This tracker addresses one of them. BLOCKING v1.0.0.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
frankenbit/release-toolkit#332
No description provided.