-
-
Notifications
You must be signed in to change notification settings - Fork 0
Verification
What has actually been checked, by what, and what has not.
The long form lives in the repository as docs/AFFIRMATION.adoc, which states
every claim alongside the command that produced it and the timestamp it ran at.
This page is the summary and the pointer.
The workspace builds and its tests pass. 13 crates; the suite runs 429
assertions across 42 suites with zero failures and zero ignored. cargo test --workspace is the whole contract — there is no suite that has to be
remembered and run by hand.
The rendered HTML is audited for structural accessibility. Every route the server exposes is swept twice, from a unit test and from an integration test, and the resulting HTML is put through fourteen structural rules:
a11y.button-text · a11y.control-label · a11y.duplicate-id ·
a11y.fake-widget · a11y.h1-count · a11y.heading-skip · a11y.img-alt ·
a11y.landmark-name · a11y.lang · a11y.link-text · a11y.main ·
a11y.positive-tabindex · a11y.skip-link · a11y.title
This is a dev-dependency; no shipped binary links it. It exists as its own crate rather than a test helper precisely so the unit sweep and the integration sweep cannot drift apart.
This wiki is checked by BerryWiki itself. The pages you are reading carry
the metadata blocks described in Page Format, berrywiki check
reports them clean, and _Sidebar.md is generated by berrywiki sidebar --write rather than hand-edited.
It answers the only part of accessibility a program can answer alone: whether the structure a screen reader and a keyboard depend on is present. It cannot tell you whether the reading order makes sense, whether a label is a good label, whether the focus ring is visible against its background, or whether the page is usable.
Colour contrast is out of scope by decision, not by omission: contrast is a property of the stylesheet rather than the document, so the ratios are recorded by hand in ADR-0012.
These are the gaps that matter, stated plainly rather than buried:
-
Token-authenticated clone and push has never been exercised. This wiki
is pushed over SSH, so ADR-0002's token path remains a plan. (The other three
GitHub assumptions — comment stripping,
_Sidebar.mdrendering on every page — were confirmed on 2026-09-15, while the--filename-to-title mapping was partly refuted by publishing this wiki and reading the rendered HTML back. See Compatibility and Limits for the evidence and its positive control.docs/AFFIRMATION.adocpredates that check and still records all four as unverified.) -
The declared minimum supported Rust version has never been built.
Cargo.tomldeclaresrust-version = "1.89"and CI carries a1.89.0matrix leg, but no green run on that leg is cited here. Treat 1.89 as declared, not demonstrated. -
BerryWiki has never been tested with a screen reader. Nothing in the
automated audit should be read as evidence that it has. The manual
walkthrough is specified in
docs/execution/a11y-walkthrough.adocand has not been run. - There are no proofs, despite the intent to have them.
- Two decisions are still open. ADR-0001 (page filename strategy) and ADR-0002 (authentication strategy) remain Proposed, because both turn on the live-GitHub spike that has not happened. See Decisions.
A tool that tells you what it has verified, and is equally specific about what it has not, can be trusted about the first list. One that only advertises the first list cannot be trusted about either.