Skip to content

docs: name the 16k measurement's host "the bundled example CRM" - #9304

Merged
os-zhuang merged 1 commit into
mainfrom
claude/issue-9293-bundled-example-noun
Aug 17, 2026
Merged

docs: name the 16k measurement's host "the bundled example CRM"#9304
os-zhuang merged 1 commit into
mainfrom
claude/issue-9293-bundled-example-noun

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Fixes#9293

Three passages measure examples/app-crm at ~16k tokens and called their subject "the whole business system" / "the entire business system". Next to the new tagline — "a complete CRM in under 150k tokens" — two different numbers were claiming the same host noun on the first screen, and 16k also collided with the README's own "business logic alone ... under 100k tokens" line.

This renames the host noun only. After it, each number owns exactly one host: 16k = the bundled example CRM · 150k = a complete CRM · 100k = the business logic alone.

The three positions (host noun before to after)

FileBeforeAfter
README.md"The CRM in this repo — ... That's the whole business system, in about 8% of a 200k-token context window.""The bundled example CRM — ... That's the whole example app, in about 8% of a 200k-token context window."
content/docs/concepts/metadata-driven.mdx"the CRM bundled in this repo" / "That's the whole business system — about 8% of a 200k-token context window.""the bundled example CRM" / "That's the whole example app — about 8% of a 200k-token context window."
content/docs/getting-started/how-ai-development-works.mdx"the CRM bundled in this repo — ... That's the entire business system, not a module of it.""the bundled example CRM — ... That's the whole example app, not a module of it."

The "8% of a 200k-token context window" sentence is the second half of the same measurement (8% is computed from 16k), so its host was renamed in step with the table above, per the card.

What was deliberately not touched

  • Both numbers stand unchanged: 31 files / 1,792 lines / roughly 16k tokens / ~16,000 / 8% / 200k. The diff contains no numeric edit.
  • The tagline copy is not edited — the finalized README hero and the 150k / 100k split lines are untouched.
  • The reproducible command stays verbatim: find examples/app-crm/src -name '*.ts' -not -name '*.test.ts' | xargs cat | wc -l.
  • content/docs/releases/** untouched. No contract surface, no code, docs prose only.

Note on the follow-on paragraphs: "when the entire business system is small, typed, and declarative ..." is a general claim with no number attached to it, so it keeps its wording — the rename is scoped to the hosts the 16k figure actually pins.

Verification

Docs-only, so no package build or test surface is involved. Gate families re-derived against the real changed paths with node scripts/pm/dispatch-gates.mjs README.md content/docs/concepts/metadata-driven.mdx content/docs/getting-started/how-ai-development-works.mdx (7 families) and run as a union at the final commit 7dbab2bc3:

HEAD=7dbab2bc3
PASS check:nul-bytes
PASS check:docs-audit-scope
PASS check:docs-redirects
PASS check:role-word
PASS spec/check:variant-docs
PASS spec/check:empty-state
PASS spec/check:liveness
PASS spec/check:strictness-ledger
HEAD_AFTER=7dbab2bc3

check:nul-bytes was added because any edit implicates it; a grep -naP control-character self-scan of the three edited files also comes back empty.

No changeset: this PR releases nothing (root README plus two docs pages), matching the precedent of the tagline PR #9242, which shipped README + docs with no changeset. skip-changeset applied.

Generated by Claude Code


Generated by Claude Code

The three passages that measure `examples/app-crm` at ~16k tokens called their
subject "the whole business system" / "the entire business system". Beside the
new tagline ("a complete CRM in under 150k tokens") that made two different
numbers claim the same host noun on the first screen.
Host nouns only; both numbers, the 8% figure and the reproducible `find … wc -l`
command are untouched, and the tagline copy is not edited here. After this each
number owns one host: 16k is the bundled example CRM, 150k the complete CRM,
100k the business logic alone.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017TNzEetykdh7ceZGwuAPLq
@github-actionsgithub-actionsBot added size/s documentation Improvements or additions to documentation labels Aug 17, 2026
@os-zhuangos-zhuang added the skip-changeset PR has no user-facing published change; bypasses the changeset gate label Aug 17, 2026 — with Claude
@os-zhuang
os-zhuang marked this pull request as ready for review August 17, 2026 12:30
@os-zhuang
os-zhuang enabled auto-merge August 17, 2026 12:30
@os-zhuang
os-zhuang disabled auto-merge August 17, 2026 17:03
@os-zhuang
os-zhuang added this pull request to the merge queueAug 17, 2026
Merged via the queue into main with commit fdbe29fAug 17, 2026
27 checks passed
@os-zhuang
os-zhuang deleted the claude/issue-9293-bundled-example-noun branch August 17, 2026 17:22
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentationImprovements or additions to documentationsize/sskip-changesetPR has no user-facing published change; bypasses the changeset gate

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs:三处 16k 度量的宿主名词改为 "the bundled example CRM"(数字不动)

2 participants

@os-zhuang@claude