docs: adopt the 'ontology is the software' positioning (README, landing page, glossary, concepts) - #21579
Conversation
… landing page, glossary and concepts Claude-Session: https://claude.ai/code/session_01VDtqoecgES7ScQYGbFVDRv Co-authored-by: Claude <noreply@anthropic.com>
Contract reviewServed-tier: ① Derived judgmentsBase: Slogan and descriptor (card table, verbatim)
Factual sentences added or changed (judged against origin/main)
page.tsx
Four guardrail facts, all survive
Census (grep -i "hold whole|small enough|business ontology" over README.md, content/docs minus references/** and releases/**, apps/docs, at head)
Boundaries
Merge-cleanliness
② Semver levelCopy only: README, one docs-app page, three MDX pages. Nothing under a released package changes, so no changeset is owed and ③ Boundary flags
Implemented-by: VERDICT: FAIL: one FALSE factual sentence — glossary.mdx:119-121 names themes as a metadata-authored projection, but the spec retired stack Generated by Claude Code |
Themes are not authorable metadata on main (stack themes carrier retired at protocol 18). Claude-Session: https://claude.ai/code/session_01VDtqoecgES7ScQYGbFVDRv Co-authored-by: Claude <noreply@anthropic.com>
Contract reviewServed-tier: ① Derived judgmentsBase: Slogan and descriptor (card table, verbatim)
Factual sentences added or changed (judged against origin/main)
page.tsx
Four guardrail facts, all survive
Census (grep -i "hold whole|small enough|business ontology" over README.md, content/docs minus references/** and releases/**, apps/docs — unchanged by the delta, which adds or removes none of the three phrases)
Boundaries
Merge-cleanliness
② Semver levelCopy only: README, one docs-app page, three MDX pages. Nothing under a released package changes, so no changeset is owed and ③ Boundary flags
Implemented-by: VERDICT: PASS: the delta removes the one FALSE sentence; every factual claim in the five copy surfaces is TRUE against origin/main, the four guardrail facts survive, the census is clean, no boundary is crossed, and the head merges clean. Generated by Claude Code |
Fixes #21574
Clause-②: no
Adopts the three-line positioning ruled on the card. Docs and copy only; nothing under
packages/**,content/docs/references/**,content/docs/releases/**, any CHANGELOG, or the dated blog post is touched. No new page, nometa.jsonchange.What changed
Surfaces:
README.md: headline blockquote leads with slogan plus descriptor (Chinese line included; the repo has no README.zh file), the "business ontology" paragraph now names the core and the no-inheritance/axioms/reasoner limit, "The other half is size" is kept as the proof, and the closing callout carries the four guardrail facts.apps/docs/app/[lang]/page.tsx: hero heading,HOME_DESCRIPTION(which feeds the meta, Open Graph, Twitter and JSON-LD descriptions, so they stay in sync), the "what that metadata is" paragraph, and the closing card.apps/docs/lib/site.tscarries no description or tagline and is unchanged. The docs app is English-only (languages: ['en']), so there are no localized hero strings.content/docs/getting-started/glossary.mdx: "Business Ontology" is now a two-way contrast (knowledge ontology vs. executable ontology; hosted ontology via the two existing bullets, kept) plus the core-versus-projections split.content/docs/concepts/index.mdxandcontent/docs/concepts/metadata-driven.mdx: one bridge sentence each, naming the split once.Guardrail facts, with evidence on main
packages/spec/src/data/object.zod.ts:1538-1541(the retired-key message forabstract, ADR-0049: "object inheritance/abstraction is not implemented"). No axiom or reasoner feature exists in the docs corpus.content/docs/data-modeling/external-datasources.mdx:248. "Early" is the card's wording.content/docs/concepts/index.mdx:93.content/docs/concepts/metadata-driven.mdx:150), actionbody(packages/spec/src/ui/action.zod.ts:1101), CEL (README.mdvalidation row), constrained JSX (README.mdsdui-parser row).The 150k/100k figures appear in none of the retained copy, so the number discipline has nothing to violate.
Acceptance notes
README.md,content/docsandapps/docs(excluding references, releases and the dated blog post). Remaining hits are the intentional proof-line uses and themetadata-driven.mdx"Small Enough to Fit" section, which is a measurement section and stays.apps/docs/lib/site.tsHERO_COVER.altstill reads "the metadata framework for AI-written apps"; the card does not list it and it describes an image, so it is left as is.HOME_TITLEis likewise unchanged.Verification
pnpm --filter @objectstack/docs build: exit 0.packages/**is untouched; the PM appliesskip-changeset.Reminder for the maintainer
The GitHub repository description lives outside git. Please paste the slogan and descriptor into it by hand:
Generated by Claude Code