#385 - docs(dry-run): dry-run docs drift from implementation — reconcile behavior claims - frankenbit/release-toolkit

bosun commented

2026-07-04 20:29:48 +02:00

Owner

Empirical finding (external cold-read round 4)

Docs describe dry-run behavior that differs from implementation. External reviewer trying to preview a release cut following the dry-run docs hit unexpected behavior (specific delta named in round-4 review body — cross-check needed).

Fix path

Compare docs/integration.md dry-run section against scripts/release-decide.sh --dry-run (and any other dry-run paths in release-prep.sh + draft-release.sh)
Reconcile: either fix docs to match implementation, or fix implementation to match docs
Add dry-run-specific test case if none exists

Verification AC

Adopter following dry-run docs sees behavior matching docs
Round-5 external cold-read finds no dry-run docs drift

Anchor

External outside-model cold-read round 4 (fresh ChatGPT session, 2026-07-03 late). Verdict: 'promising but not yet trustworthy' — SAME TIER as round-3 despite round-3 delta cycle. Meta-pattern named this round: grep-sweep-missed-siblings — the sweep-pattern targeted the literal grep-target, not the semantic class, so class-axis closed PARTIALLY per round. Operator ratified filing round-4 trackers 2026-07-04. This tracker addresses one of the round-4 findings. Success criterion: subsequent external cold-read returns no further objections of this class.

Priority/medium, size/S.

## Empirical finding (external cold-read round 4) Docs describe dry-run behavior that differs from implementation. External reviewer trying to preview a release cut following the dry-run docs hit unexpected behavior (specific delta named in round-4 review body — cross-check needed). ## Fix path - Compare docs/integration.md dry-run section against `scripts/release-decide.sh --dry-run` (and any other dry-run paths in release-prep.sh + draft-release.sh) - Reconcile: either fix docs to match implementation, or fix implementation to match docs - Add dry-run-specific test case if none exists ## Verification AC - Adopter following dry-run docs sees behavior matching docs - Round-5 external cold-read finds no dry-run docs drift ## Anchor External outside-model cold-read round 4 (fresh ChatGPT session, 2026-07-03 late). Verdict: 'promising but not yet trustworthy' — SAME TIER as round-3 despite round-3 delta cycle. Meta-pattern named this round: grep-sweep-missed-siblings — the sweep-pattern targeted the literal grep-target, not the semantic class, so class-axis closed PARTIALLY per round. Operator ratified filing round-4 trackers 2026-07-04. This tracker addresses one of the round-4 findings. Success criterion: subsequent external cold-read returns no further objections of this class. Priority/medium, size/S.

bosun added the

priority/medium

size/S

kind/docs

labels

2026-07-04 20:29:48 +02:00

quartermaster referenced this issue from a commit

2026-07-04 20:52:54 +02:00

docs: draft-release.sh header refresh + integration.md dry-run section accuracy (#383 + #385)

quartermaster referenced this issue from a pull request that will close it,

2026-07-04 20:53:27 +02:00

docs: draft-release.sh header refresh + integration.md dry-run section accuracy (#383 + #385) #389

quartermaster closed this issue

2026-07-04 20:56:49 +02:00

quartermaster referenced this issue from a commit

2026-07-04 20:56:49 +02:00

docs: draft-release.sh header refresh + integration.md dry-run section accuracy (#383 + #385)

quartermaster commented

2026-07-04 20:56:51 +02:00

Owner

Delta merged via PR #389. docs/integration.md § Dry-run preview rewritten to be script-specific (release-decide/release-prep/draft-release each described) + corrected the false 'still needs an origin remote' note (remote-less clones work for dry-run; origin only used for OWNER/REPO derivation + Forgejo API calls, both of which have dry-run allowances).

release-bot referenced this issue

2026-07-04 20:58:29 +02:00

chore(release): v0.26.0 #327

Rows
Columns

docs(dry-run): dry-run docs drift from implementation — reconcile behavior claims #385

Empirical finding (external cold-read round 4)

Fix path

Verification AC

Anchor