Skip to content

sweep: docs-audit wave (#10563) — 13 factual corrections across content/docs/** where the page contradicts the enforced platform #10616

Description

@os-zhuang

Anchor card for the sweep-package promotion of the 2026-08-21 docs-audit finding wave (audit dispatch: #10563, closed). Triage seat authored per the batch-promotion rules (five gates below). This card is the claim/dispatch object; the member cards keep their finding label and are NOT dispatch candidates.

Family criterion (gate ①)

Every member is the same defect shape: a content/docs/** page states something the current enforced platform contradicts, and the fix is a prose/example correction on that page against the cited source of truth. No member changes any contract, schema, or gate.

Members (13)

IssuePage(s)One-line defect
#1058112 pages (list in card)22 ObjectSchema.create() examples omit sharingModel; os validate errors on every one (SECURITY_OWD_UNSET)
#10582getting-started/examples.mdx"Quick Run" omits the required pnpm build, contradicts README.md:210-212
#10583getting-started/index.mdxadvertises GraphQL via IGraphQLService — contract does not exist, /graphql removed
#10584data-modeling/field-types.mdx:533, validation-rules.mdx:373location value documented {latitude,longitude}; enforced contract is {lat,lng} (field-value.zod.ts:251-256)
#10585data-modeling/validation.mdxretired partial index key presented as live
#10586data-modeling/index.mdxstill sells joins + window functions, both retired in protocol 17
#10587validation-rules.mdxpromises constraints for "each field type", covers 44 of 49
#10588data-modeling/field-types.mdxsays unknown field keys are "stripped" — FieldSchema is a strictObject that rejects with guidance (ADR-0078)
#10589validation-rules.mdxsays currency is stored as {value,currency} — it is a bare number
#10590data-modeling/schema-design.mdxapiMethods sample says "six primitives" and lists five — silently denies bulk
#10591data-modeling/index.mdx"Four database drivers" — there are five; driver-turso omitted
#10578ui/actions.mdxrowActions/bulkActions shown at defineView container top level — strictObject rejects it
#10579ui/ form-section pages3 of 5 form-section examples omit name

Read each member card in full before editing — each carries exact line numbers, the source-of-truth citation, and (for #10581) the full 22-site table.

Gates ②–⑤

Dispatch notes (for the devx seat)

Triage: lands in content/docs/**domain:devx; concrete named landing spots, no open questions ⇒ pm:queue.

Metadata

Metadata

Assignees

Labels

Type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions