From 37d0c2a3b47393e8609dbd760b1dbcea4ed401be Mon Sep 17 00:00:00 2001 From: Bryan Fawcett Date: Tue, 8 Sep 2026 15:11:15 +0000 Subject: [PATCH] docs: un-swap the accent colours, which failed both real pairings MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit In Mintlify's `colors` block the key names the colour, not the mode: `light` is the accent used *in dark mode*, `dark` the one used in light mode. They were assigned the other way round, so both pairings that actually render failed contrast — the brown accent on the near-black ground at 2.45:1, the tan one on the near-white ground at 1.99:1. Swapping them gives 7.82:1 and 6.34:1, both AA, confirmed by `mint a11y`. The naming is counter-intuitive enough that the same mistake already bit the favicon during the SEO pass, so docs/README.md now states the rule and warns against "fixing" it by matching key to mode. That note also records why `mint a11y` stays out of the CI gate: it measures `dark` against the dark background as well, a pairing that never renders, so it cannot reach exit 0 under any assignment. Both gated commands — `mint validate` and `mint broken-links` — pass. Refs #27 Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_0122JtRC4Dbptgefu7QR8gvZ --- docs/README.md | 7 +++++++ docs/docs.json | 4 ++-- 2 files changed, 9 insertions(+), 2 deletions(-) diff --git a/docs/README.md b/docs/README.md index 358a516..68ee436 100644 --- a/docs/README.md +++ b/docs/README.md @@ -50,6 +50,13 @@ The Mintlify GitHub App posts its own `Mintlify Deployment` check, but that one reports `skipped` on pull requests: it runs on the deploy branch only. It is not a pre-merge guarantee, which is what the two commands above are for. +`mint a11y` is deliberately not gated. In `docs.json` the accent keys name the +colour, not the mode — `light` is the accent used *in dark mode* and `dark` the +one used in light mode — so do not "fix" them by matching key to mode; that is +how they came to be swapped. The two real pairings pass AA (7.82:1 and 6.34:1), +but the command also measures `dark` against the dark background, a pairing that +never renders, so it cannot reach exit 0 whatever the assignment. + Every normative claim in `spec/` should be true of the reference implementation, or say plainly where it is not — see the *Status of This Document* section in [`spec/overview.mdx`](spec/overview.mdx). A specification diff --git a/docs/docs.json b/docs/docs.json index ab8d33a..a6dc4cf 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -4,8 +4,8 @@ "theme": "aspen", "colors": { "primary": "#8B4513", - "light": "#8B4513", - "dark": "#D4A574" + "light": "#D4A574", + "dark": "#8B4513" }, "navbar": { "links": [