Skip to content

fix(accessibility): "Using ARIA" is a discontinued draft — cite the ARIA in HTML REC - #138

Merged
jdevalk merged 1 commit into
mainfrom
fix/aria-using-aria-discontinued-2026-07-31
Jul 31, 2026
Merged

fix(accessibility): "Using ARIA" is a discontinued draft — cite the ARIA in HTML REC#138
jdevalk merged 1 commit into
mainfrom
fix/aria-using-aria-discontinued-2026-07-31

Conversation

@jdevalk

@jdevalk jdevalk commented Jul 31, 2026

Copy link
Copy Markdown
Owner

What changed

src/content/spec/accessibility/aria-usage.md:

  • Source swap. Replaced https://www.w3.org/TR/using-aria/ with ARIA in HTML. The page keeps four sources.
  • Corrected a factual claim. The body said "The W3C's own guide leads with five rules". The guide has four numbered Rules of ARIA Use. The accessible-name requirement (previously listed as rule 5) is kept, but attributed to WCAG 4.1.2 — which the page already cites — rather than to that list.
  • New short paragraph in ## Why it matters on the element-by-element conformance table, with three verified examples: role="button" on <a href> is permitted; <textarea> accepts no role other than textbox; <input type="hidden"> accepts no role or aria-* at all.

Why now

Two things moved under this page:

  1. "Using ARIA" was marked a Discontinued Draft on 24 February 2026. Its own status section now reads: "Using ARIA is a Discontinued Draft. the four rules of ARIA are kept for historical purposes and for easier reference, but there are no plans to continue work on this document." We were citing it as live W3C guidance.
  2. ARIA in HTML reached W3C Recommendation on 15 April 2026 (CR → REC). It is the normative specification of which ARIA roles, states, and properties are valid on which HTML elements — precisely the ground the discontinued draft used to cover, and precisely what this page's "reach for native HTML first" argument rests on.

Primary sources

  • ARIA in HTML — W3C Recommendation, 15 April 2026.
  • Using ARIA — Discontinued Draft, 24 February 2026 (the citation being retired).

Status

Unchanged: recommended. Nothing about the platform contract moved — this is a citation-accuracy and factual-accuracy repair, not a promotion.

Notes

  • Page count and categories unchanged, so no SKILL.md / digest work. npm run build passes; the pre-commit skill-drift check is green (164 pages, 10 categories).
  • No changelog entry included. It sits on the borderline described in CLAUDE.md — more than a typo fix (a factual claim in the body changed), less than a substantive rewrite. Flagging rather than deciding: say the word and I will add a changed entry.

🤖 Generated with Claude Code

W3C marked "Using ARIA" (/TR/using-aria/) a Discontinued Draft on
24 February 2026, and it lists four rules, not the five the page claimed.
ARIA in HTML reached W3C Recommendation on 15 April 2026 and is the
normative answer to which roles are allowed on which elements.

- Swap the discontinued draft for the ARIA in HTML Recommendation.
- Correct "five rules" to four; keep the accessible-name requirement,
  attributed to WCAG rather than to that list.
- Add a short paragraph on the element-by-element conformance table.

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

Copy link
Copy Markdown

Deploying specification-website with  Cloudflare Pages  Cloudflare Pages

Latest commit: 0a1adf7
Status: ✅  Deploy successful!
Preview URL: https://fbe59061.specification-website.pages.dev
Branch Preview URL: https://fix-aria-using-aria-disconti.specification-website.pages.dev

View logs

@jdevalk
jdevalk marked this pull request as ready for review July 31, 2026 09:12
@jdevalk
jdevalk merged commit 52feab0 into main Jul 31, 2026
7 of 8 checks passed
@jdevalk
jdevalk deleted the fix/aria-using-aria-discontinued-2026-07-31 branch July 31, 2026 09:12
jdevalk added a commit that referenced this pull request Jul 31, 2026
…#143)

The changelog records when *this spec* changed, not when the world did, so
`date` is the day the entry lands on main. Three entries kept the date their
PR was authored (28th, 28th, 30th) though all three merged on the 31st.

- Re-date tdmrep, mcp-handshake and websub to 2026-07-31, renaming each file
  so the stem still matches. All three went live under an hour ago, so the
  GUID churn this causes in the changelog feed is as small as it will ever be.
- Add a `changed` entry for ARIA in HTML reaching Recommendation and "Using
  ARIA" being discontinued (#138).
- Add a `changed` entry for the expired aipref attachment draft (#131). That
  one was merged unlogged; it rewrote what the page says about the topic's
  standing, which is not a citation repair.
- Record the dating rule in CLAUDE.md, including why renaming a live entry is
  not free: the filename stem is `entry.id`, which is both the `<li>` anchor
  and the feed's `#`-link.

Deliberately not logged: #122 (worked-example callout gained a sentence; the
recommendation did not move) and #141 (plumbing, and the hub is not live —
fold it into the WebSub entry when D1 is provisioned).

Co-authored-by: Claude Opus 5 (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