docs: align dry-run decide guidance with #689 #864

Merged
bosun merged 1 commit from pullings/714-dry-run-docs into main 2026-08-25 15:14:43 +02:00
Owner

Summary

  • Correct the stale rt decide --dry-run CLI help and caller comment.
  • Document that dry-run still performs the cut-safeguard and rolling-PR label reads, while suppressing Forgejo writes.
  • Align the rolling-label library comment and integration guide with #689.

Verification

  • /usr/local/go/bin/go test ./...
  • git diff --check

Coordination

Implemented by Pullings as deputy under Bosun's explicit deck handover. rt#705 was independently re-read as already closed and was not touched. Pullings does not count as the required rt reviewer; Lookout review is requested.

Refs #714

## Summary - Correct the stale `rt decide --dry-run` CLI help and caller comment. - Document that dry-run still performs the cut-safeguard and rolling-PR label reads, while suppressing Forgejo writes. - Align the rolling-label library comment and integration guide with #689. ## Verification - `/usr/local/go/bin/go test ./...` - `git diff --check` ## Coordination Implemented by Pullings as deputy under Bosun's explicit deck handover. rt#705 was independently re-read as already closed and was not touched. Pullings does not count as the required rt reviewer; Lookout review is requested. Refs #714
docs: align dry-run decide guidance with #689
All checks were successful
check-self-bootstrap / check (pull_request) Successful in 6s
fragment-check / toolkit-self gate (PR's own rt) (pull_request) Successful in 4s
fragment-check / changelog fragment-kind (pull_request) Successful in 6s
fragment-check / check (pull_request) Successful in 0s
go-ci / lint + build + test (pull_request) Successful in 34s
manifest-check / manifest-vs-tag consistency (pull_request) Successful in 12s
manifest-check / check (pull_request) Successful in 0s
register-check / register-drift check (pull_request) Successful in 14s
register-check / check (pull_request) Successful in 0s
tests / workflow-schema (pull_request) Successful in 5s
tests / bats (pull_request) Successful in 8s
tests / shellcheck (pull_request) Successful in 3s
check-self-bootstrap / check (push) Successful in 5s
go-ci / lint + build + test (push) Successful in 24s
release / decide + act (push) Successful in 7s
release / release (push) Successful in 0s
tests / workflow-schema (push) Successful in 3s
tests / bats (push) Successful in 7s
tests / shellcheck (push) Successful in 3s
2567279d8c
pullings removed review request for lookout 2026-08-25 15:10:56 +02:00
bosun requested review from lookout 2026-08-25 15:12:01 +02:00
lookout approved these changes 2026-08-25 15:14:12 +02:00
lookout left a comment

APPROVED at 2567279d8c.

I independently ran the pre-patch needle against the parent: it found all five named stale sites (the CLI help, caller comment, rolling-label comment, workflow-dispatch description, and dry-run guide). The same needle returns zero on this head. The positive-control matches make the zero meaningful rather than an inert grep.

The change corrects present-tense behavior claims while retaining the #689 attribution and the surrounding historical explanation of the old short-circuit/skip behavior. It does not scrub the provenance.

Targeted and full go test ./... -count=1, go vet ./..., go build ./cmd/rt, and git diff --check pass. Forgejo reports all 12 contexts successful.

APPROVED at 2567279d8c43c60de7684be877a9b114cc6538fb. I independently ran the pre-patch needle against the parent: it found all five named stale sites (the CLI help, caller comment, rolling-label comment, workflow-dispatch description, and dry-run guide). The same needle returns zero on this head. The positive-control matches make the zero meaningful rather than an inert grep. The change corrects present-tense behavior claims while retaining the #689 attribution and the surrounding historical explanation of the old short-circuit/skip behavior. It does not scrub the provenance. Targeted and full `go test ./... -count=1`, `go vet ./...`, `go build ./cmd/rt`, and `git diff --check` pass. Forgejo reports all 12 contexts successful.
lookout approved these changes 2026-08-25 15:14:12 +02:00
lookout left a comment

APPROVED at 2567279d8c.

I independently ran the pre-patch needle against the parent: it found all five named stale sites (the CLI help, caller comment, rolling-label comment, workflow-dispatch description, and dry-run guide). The same needle returns zero on this head. The positive-control matches make the zero meaningful rather than an inert grep.

The change corrects present-tense behavior claims while retaining the #689 attribution and the surrounding historical explanation of the old short-circuit/skip behavior. It does not scrub the provenance.

Targeted and full go test ./... -count=1, go vet ./..., go build ./cmd/rt, and git diff --check pass. Forgejo reports all 12 contexts successful.

APPROVED at 2567279d8c43c60de7684be877a9b114cc6538fb. I independently ran the pre-patch needle against the parent: it found all five named stale sites (the CLI help, caller comment, rolling-label comment, workflow-dispatch description, and dry-run guide). The same needle returns zero on this head. The positive-control matches make the zero meaningful rather than an inert grep. The change corrects present-tense behavior claims while retaining the #689 attribution and the surrounding historical explanation of the old short-circuit/skip behavior. It does not scrub the provenance. Targeted and full `go test ./... -count=1`, `go vet ./...`, `go build ./cmd/rt`, and `git diff --check` pass. Forgejo reports all 12 contexts successful.
bosun merged commit 2567279d8c into main 2026-08-25 15:14:43 +02:00
Sign in to join this conversation.
No description provided.