docs(v0.44): synchronize public API, authoring model and release truth (#1218) - #1261
Merged
Conversation
#1218) Alpha.10 truth closure (H5 class). A new mechanical removed-vocabulary gate in check-docs-truth found 54 drift findings across 16 files at baseline; all fixed to the BASE_SHA source truth: - package READMEs rewritten to the current compiled authoring model (@element/@Property intrinsics, class-first definePage); create README dist-tag claim corrected to the 0.43 line - SECURITY.md overclaim removed (only dependency-review + CodeQL are wired; Gitleaks/actionlint/zizmor/Scorecard marked planned via #1156) - README.zh alpha-lag claim removed (alphas are internal under ADR-0151) - www guide/architecture content re-authored (canonical imports, projector pattern, compiled claim vocabulary); HYDRATION_CONTRACT and PACKAGE_SURFACE updated; integrations docs fixed - check-docs-truth current gate now mechanically rejects removed authoring vocabulary (defineElement, useLoaderData, useActionData, bindSsrProps, registerSignal, <For>, VNode-as-current) on current surfaces; historical records allow-listed Follow-up filed for out-of-scope www/app surfaces: #1260. Implemented by fresh kimi-code/k3-256k HIGH session (.agents/v044-kimi-implementer.md), packet A10.10. No publish, no tag.
Contributor
|
APIError: Insufficient Balance |
Deploying openelement with
|
| Latest commit: |
d298f9f
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://00d8965e.lessjs.pages.dev |
| Branch Preview URL: | https://v044-a10-10-docs-truth.lessjs.pages.dev |
This was referenced Sep 2, 2026
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.
Problem
Issue #1218 (umbrella #1155, Alpha.10, H5 class). Public-facing truth drifted from source: package READMEs taught removed APIs (defineElement/VNode/object-descriptor definePage), SECURITY.md claimed unwired tools, README.zh described an alpha-lag policy impossible under ADR-0151, www guides used removed authoring vocabulary, HYDRATION_CONTRACT referenced marker-activation/For-era semantics.
Evidence-first approach
Extended
tools/check-docs-truth.tswith a mechanical removed-vocabulary gate (test-first, 3 unit tests). At baseline it found 54 drift findings across 16 files — every one fixed to source truth; gate now green and prevents regression.Evidence
deno task testnot run — docs-only + checker change; no package/e2e test references the edited documents (grep-verified); stated per packet rule.Scope / non-goals
No docs framework; no historical-record rewrites (docs/audit, ADR bodies, migration guide's historical sections allow-listed); no www visual redesign. Out-of-scope drift filed as #1260 (www/app apilist/page-home + desktop-reader comments).
Risk
Docs-only + one checker extension. Rollback: revert.