Say that pull requests shipped, and write the migration check out Two documents had drifted away from the system they describe, in opposite directions. `priv/docs/welcome.md` listed pull requests under "What is not here yet". They ship: `/:owner/:repo/pulls` and `/pulls/:number` render in the browser, the API serves index, show, create, update, and the stack operations beside them, and five documentation pages describe all of it. That page's own rule is that "where a page in these docs describes something, that thing exists and you can click it", and a reader who believed the sentence would never click. What is actually missing is narrower and is now stated as such: a pull request can be opened, browsed with its diff, commented on, and merged, but nothing records an approval, a requested change, or a comment anchored to a line. Webhooks are still absent. The page also called the CLI npm-distributed; it is one native binary, and the sentence now points at Coder and its installer. `docs/operations/production-deploy-runbook.md` told an operator to verify a data-bearing migration by evaluating `/tmp/check.exs` -- a file the runbook never shows you how to write. A step you have to invent is a step that goes unreviewed, which is the opposite of what a verification step is for, and it also failed `ExitRehearsalRunbookTest`: that test parses every `rpc` command under `docs/` and requires it to call a function that exists, precisely so a runbook step cannot read as executable without being it. `Code.eval_file/1` named no OpenAgents function, so the gate had been red on `main` since 8f282e9. The three checks the prose already asks for are now three commands: the rows the backfill should have written, the column's nullability and default, and the constraints on the table. Each was run against a real database before being written down. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014wPUM1Fr44hwBGPP42iMxP
- Co-Authored-By
- Claude Opus 5 (1M context) <noreply@anthropic.com>
- Claude-Session
- https://claude.ai/code/session_014wPUM1Fr44hwBGPP42iMxP