codex-bot-andresmgsl/ceremony
1
0
Fork 0
forked from heavy-duty/ceremony
Code Pull requests Activity

docs(builder): cite what this file carries, not what crew's engine does

Browse source 
The first paragraph referred to a 15-minute cadence and a checkpoint
discipline, neither of which BUILDER.md states — the cadence is crew's
engine rule and the pointer sent a reader to a section that says nothing
about it. Attribute the measurement to crew#139 and point at what
Building actually says. The LABELS.md sentence stops restating the
state:building row's condition and points at it instead: one rule in two
voices, per #258's test plan.

Refs #258
This commit is contained in:
cndgrr 2026-08-03 21:51:25 +00:00
parent 6634a517bc
commit dbbdbdb6dd
1 changed files with 12 additions and 13 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

25
BUILDER.md
View file

@ -298,19 +298,18 @@ CONTRIBUTING; the shared flow lives here and is not restated there.)
([#50 D11](https://github.com/heavy-duty/ceremony/issues/50)). ([#50 D11](https://github.com/heavy-duty/ceremony/issues/50)).
**A fix round may ride a draft.** An engine may convert a PR back to draft **A fix round may ride a draft.** An engine may convert a PR back to draft
when a round closes, and crew#139's does: the 15-minute cadence makes a when a round closes, and crew#139's does — an engine whose own rules make a
builder's fix-round pushes *saves* rather than proposals, and 41 of 106 builder's mid-round pushes *saves* rather than proposals fires CI at every one
commits across crew's last 25 PRs — 39% — were fired at CI as if they were of them otherwise, 41 of 106 commits across crew's last 25 PRs by that
proposals. Ceremony implements no such conversion and this passage specifies issue's measurement. Ceremony implements no such conversion and this passage
none; it is written down because a builder or a reviewer who meets a mid-round specifies none; it is written down because a builder or a reviewer who meets a
draft has to find a state the doctrine describes. What it means is what a mid-round draft has to find a state the doctrine describes. What it means is
draft already meant during the build, extended and not changed: the draft what a draft already meant while you were building, extended and not changed:
phase is yours, the panel cannot see it, and the checkpoint discipline the draft phase is yours and the panel cannot see it (Building, above). Whose
(Building, above) runs through the round unaltered. Whose ball it is does not ball it is does not change either — the round outranks the draft, so you still
change either — the round outranks the draft flag, which is what owe it whole, the fixes and the reply and the flip. The label axis says the
[LABELS.md](LABELS.md)'s `state:building` row already says in the machine's same thing in the machine's voice rather than in this one, and
voice: a draft carrying a standing non-approving verdict is a fix round and [LABELS.md](LABELS.md)'s `state:building` row is where to read it (#205).
reads `state:addressing` (#205).
**Ready-for-review is the act that ends the round, and it is the builder's **Ready-for-review is the act that ends the round, and it is the builder's
alone.** No engine marks a PR ready. The flip asserts that the round was alone.** No engine marks a PR ready. The flip asserts that the round was