Repository navigation
Drop issue numbers and honest from eight docs pages - #1463
Merged
Merged
Conversation
- Open issues #108 and #854 are links in policy.md, status.md and the desktop-recording site page. ADR 0003 drops the PR number from its status line and names the reclamation rule in place of "Invariant 7". - "honest new release" reads "benign new release" in restricted-codex-analysis.md (it means a release not built to evade the qualifier). task-protocol-support.md and public-readiness-standard.md drop honest. - The comms-inbox site page says what "canonical base64" meant: the renderer re-encodes the bytes and compares (src/comms/images.ts). - status.md's table is realigned by oxfmt; git diff -w shows the one changed row. Counts by the docs prose ratchet (#1459), before -> after: docs issue-refs 37 -> 34, invariant-refs 14 -> 13, honest 23 -> 19; site issue-refs 2 -> 1, authority 1 -> 0. The remaining site issue ref is in save-button-study.mdx, which #1458 also edits. Checked: format:check, docs:check, prose:check, site registry:check, the luxin slop check (0 hits), the counts above with #1459's checker. Not checked: rendered pages. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
danielgwilson
added a commit
that referenced
this pull request
Oct 3, 2026
prose:check now reads the current docs under three roots, each capped in scripts/caps.json at prose.<root>.<kind>: - docs: the root guides (README, AGENTS, ARCHITECTURE, CONTEXT, CONTRIBUTING, SECURITY, TELEMETRY) and docs/ outside history/ and evidence/. - site: site/content/docs/*.mdx except the generated cli.mdx. - evidence: docs/evidence/. Dated study records are capped so a new record adds no tells, and are not cleaned, since a record keeps the words it was written in. docs/history/ and CHANGELOG.md are not read. Kinds: issue-refs, caps, em-dashes, invariant-refs, authority, honest, archaeology (plus SLICE 2, phase 2, PR1 of) and contrast (not just, not merely, rather than). scripts/lib/doc-prose.mjs blanks front matter, fenced code, code spans, link targets, URLs and markup tags before counting, and reads repo file names and acronyms (README, WAI-ARIA) as names in the caps count. Caps are the counts on 9f033af, after the docs cleanups #1446, #1452, #1454, #1455, #1462, #1463, #1471, #1472 and #1476, in the kind order above: docs 1/0/0/0/0/1/0/20, site 0/0/0/0/0/0/0/11, evidence 102/64/31/1/3/5/2/11. The docs issue-ref and honest at 1 are the last hits, which #1486 removes. The 20 docs and 11 site contrast hits each name two alternatives a reader would weigh. AGENTS.md and CONTRIBUTING.md say prose:check covers docs. Checked on 9f033af: format:check, lint, knip, docs:check, prose:check, vocabulary:check, typecheck, tests/scripts (211 tests, 5 new in check-doc-prose.test.ts), check-cap-direction against origin/main (new caps only). Not checked: the full vitest suite. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
danielgwilson
added a commit
that referenced
this pull request
Oct 3, 2026
prose:check now reads the current docs under three roots, each capped in scripts/caps.json at prose.<root>.<kind>: - docs: the root guides (README, AGENTS, ARCHITECTURE, CONTEXT, CONTRIBUTING, SECURITY, TELEMETRY) and docs/ outside history/ and evidence/. - site: site/content/docs/*.mdx except the generated cli.mdx. - evidence: docs/evidence/. Dated study records are capped so a new record adds no tells, and are not cleaned, since a record keeps the words it was written in. docs/history/ and CHANGELOG.md are not read. Kinds: issue-refs, caps, em-dashes, invariant-refs, authority, honest, archaeology (plus SLICE 2, phase 2, PR1 of) and contrast (not just, not merely, rather than). scripts/lib/doc-prose.mjs blanks front matter, fenced code, code spans, link targets, URLs and markup tags before counting, and reads repo file names and acronyms (README, WAI-ARIA) as names in the caps count. Caps are the counts on 9983746, after the docs cleanups #1446, #1452, #1454, #1455, #1462, #1463, #1471, #1472, #1476 and #1486, in the kind order above: docs 0/0/0/0/0/0/0/20, site 0/0/0/0/0/0/0/11, evidence 102/64/31/1/3/5/2/11. The 20 docs and 11 site contrast hits each name two alternatives a reader would weigh. AGENTS.md and CONTRIBUTING.md say prose:check covers docs. Checked on 9983746: format:check, lint, knip, docs:check, prose:check, vocabulary:check, typecheck, tests/scripts (231 tests, 5 new in check-doc-prose.test.ts), check-cap-direction against origin/main (new caps only). Not checked: the full vitest suite. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Docs only. This is the second cleanup against #1459's counts, on pages that no open PR touches.
What changed
docs/contracts/policy.md,docs/status.mdandsite/content/docs/desktop-recording.mdx.restricted-codex-analysis.md: "honest new release" now reads "benign new release". It means a release that was not built to evade the qualifier.task-protocol-support.mdandpublic-readiness-standard.mddrop "honest".site/content/docs/comms-inbox.mdxnow says what "canonical base64" meant: the renderer re-encodes the bytes and compares them (src/comms/images.ts:17).status.md.git diff -wshows the one changed row.Counts (from #1459's checker)
The remaining site issue ref is in
save-button-study.mdx. #1458 also edits that file, so it waits for #1458.These
rather thanstay because each names two alternatives a reader would weigh:browser-control.md: calls are rejected, not queued.three-roles.md: researchers synthesize, instead of letting the room decide.automatic-analysis.md: the state is unknown, not falsely complete.public-readiness-standard.md: private data vs maintainer metadata.CONTEXT.md: theCONCURRENT_prefix vs reusing the old one.Merge order: whichever of this PR and #1459 lands second lowers the caps. I will do that rebase.
Release line: none. This changes docs only.
Checked
registry:check.Not checked
🤖 Generated with Claude Code