Repository navigation
docs: evidence foundation, verified references, concept template - #576
Merged
mvilacad merged 4 commits intoOct 25, 2026
Merged
Conversation
mvilacad
force-pushed
the
feat/571-docs-evidence-foundation-methodology-page-verified
branch
from
October 25, 2026 10:34
2427f1d to
9d08a19
Compare
mvilacad
marked this pull request as ready for review
October 25, 2026 10:34
mvilacad
deleted the
feat/571-docs-evidence-foundation-methodology-page-verified
branch
October 25, 2026 10:34
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
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.
Closes #571
Part 1 of the Concepts program: the contract that keeps claims about users honest.
What ships
/docs/concepts/evidence/: five claim-level strength labels (established, supported, preliminary, practice, heuristic), nine rules, how to read the atlas, how to validate, a Limits box with a review date. No "science" branding: the section is Evidence.site/src/data/evidence/references.json(45 sources). Every one was opened onverified.date, with the wording relied on kept asverified.excerptand the route used inverified.how. All 45 areclaim-read.<Claim>,<Limits>,<Refs>docs components and the concepts index with the nine-part page template./llms/concepts/*.txt).packages/ui/tests/evidence-rules.test.ts): banned phrases, a kind caps the strength (a standard ispractice, a vendor studypreliminary), every cited source exists and was read, every claim has scope and sources, every concept has a dated Limits box and References, checklists are plain lists.Fail before, pass after
has read the wording of every source it recordsfirst failed on E07 (excerpt was only the page title). Re-read the WCAG quick reference, recorded the 1.4.10, 2.4.11 and 2.5.8 wording: passes.how): bothclaim-read, so the old "identity only" escape hatch and its vacuous test are gone.Verified
bun test packages/ui/tests/evidence-rules.test.ts: pass. Pre-pushvalidate: ok.Left open
Nothing for this layer. #578 (atlas) and #586 (concepts) are stacked on this branch.