ARIA page template doesn't document attribute page sections

Open Beginner friendly
#46,494 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

@caugner is already working on this.

Since Nov 12, 2026.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
76/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Domain
documentation

Research direction

Read the ARIA page template at the MDN URL in the issue and compare its section list with the attribute pages described there. Decide whether to document “Values,” “Associated roles,” and “Associated interfaces,” or clarify that attribute pages use another template. Done when the template accurately explains the sections used by attribute pages.

Written by the indexing model from the issue text.

Description

Content:Meta needs triage
MDN URL

https://developer.mozilla.org/en-US/docs/MDN/Writing_guidelines/Page_structures/Page_types/ARIA_Page_Template

What specific section or headline is this issue about?

ARIA attribute pages, and the ARIA page template's section list.

What information was incorrect, unhelpful, or incomplete?

The ARIA page template is also used for ARIA attribute pages, but attribute pages use sections the template doesn't list: "Values" (53 of 53 pages), "Associated roles" (53 of 53), and "Associated interfaces" (46 of 53). The template's "Accessibility concerns", "Best practices", and "Precedence order" don't appear on any attribute page.

What did you expect to see?

Either the template documents the sections attribute pages use, or it says that attribute pages have their own template.

Do you have any supporting links, references, or citations?

Related to https://github.com/mdn/content/pull/46488

Do you have anything more you want to share?

No response

Dominant language
Markdown
Stars
11.1k
Forks
23.3k
Avg merge
2d 14h
Merged PRs (30d)
165

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from mdn/content

All issues in mdn/content

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.