Skip to content

content(accessibility): add Accessible authentication (WCAG 2.2 SC 3.3.8/3.3.9)#42

Merged
jdevalk merged 1 commit into
mainfrom
content/accessible-authentication
Jun 17, 2026
Merged

content(accessibility): add Accessible authentication (WCAG 2.2 SC 3.3.8/3.3.9)#42
jdevalk merged 1 commit into
mainfrom
content/accessible-authentication

Conversation

@jdevalk

@jdevalk jdevalk commented Jun 17, 2026

Copy link
Copy Markdown
Owner

What this changes

Adds a new Accessibility spec page: accessible authentication.

WCAG 2.2 introduced two login-focused success criteria — 3.3.8 Accessible Authentication (Minimum, AA) and 3.3.9 (Enhanced, AAA) — which forbid any authentication step that relies on a cognitive function test (recalling a password, transcribing a code, solving a CAPTCHA) unless an accessible alternative is offered. The page covers supporting password managers (autocomplete="current-password"), allowing paste everywhere, autocomplete="one-time-code" for OTPs, offering passkeys/WebAuthn, not making a CAPTCHA the only gate, and magic-link fallbacks.

  • Status: recommended, order: 115, appliesTo: [all]
  • Sources (standards-weighted): WCAG 3.3.8, WCAG 3.3.9, W3C WebAuthn, MDN autocomplete.

Derived/required surfaces included

  • Changelog entry (type: added) linking the new page inline.
  • OG images: the new page image plus the four count-driven images it bumps (og-default, og/checklist, og/spec, og/spec/accessibility).
  • relatedSlugs cross-links added on four adjacent pages so the graph stays bidirectional: form-errors, form-labels, mobile-form-inputs, and well-known webauthn.

Follow-ups before/after merge

  • Agent Skill (agent-skills/specification-website/SKILL.md) page count + digest not yet bumped.
  • Redeploy the MCP Worker after merge (cd mcp && npm run deploy) so mcp.specification.website picks up the new page.

🤖 Generated with Claude Code

…3.8/3.3.9)

WCAG 2.2 (W3C Recommendation, Dec 2024) added two success criteria about
logging in — 3.3.8 Accessible Authentication (Minimum, AA) and 3.3.9
(Enhanced, AAA) — which forbid relying on a cognitive function test
(recalling a password, transcribing a code, solving a puzzle) unless an
accessible alternative exists. The spec had no page on this.

New page covers supporting password managers, allowing paste,
autocomplete="one-time-code", passkeys/WebAuthn, and CAPTCHA alternatives.
Status: recommended — it's a new AA criterion in the current WCAG REC, but
the web platform does not break without it.

- Wires reciprocal relatedSlugs on form-labels, form-errors,
  mobile-form-inputs, and well-known/webauthn.
- Adds the changelog entry and the count-driven + per-page OG images.
- SKILL.md left unchanged: it says "130+ pages" (not an exact count), still
  accurate at 138; category list and tool table unchanged, so no digest bump.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying specification-website with  Cloudflare Pages  Cloudflare Pages

Latest commit: b5fe9d6
Status: ✅  Deploy successful!
Preview URL: https://6a424ee6.specification-website.pages.dev
Branch Preview URL: https://content-accessible-authentic.specification-website.pages.dev

View logs

@jdevalk jdevalk merged commit b855a75 into main Jun 17, 2026
8 checks passed
@jdevalk jdevalk deleted the content/accessible-authentication branch June 17, 2026 13:18
jdevalk added a commit that referenced this pull request Jun 17, 2026
PR #42 (accessible-authentication) branched before #40 (reporting-endpoints)
landed, so its committed count images showed 138. With both pages now on
main the total is 139 — regenerate og-default, checklist, and spec.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant