Most teams build it from the WAI-ARIA 1.2 specification by parsing the role taxonomy into a JSON array. Each row captures category, inheritance, supported states, required parent and abstract flag. The array is committed as data/aria-roles.json and refreshed whenever the spec ships an update.

Abstract roles like widget, command and composite get a row with the abstract flag set. The template renders a banner explaining that the role cannot be used directly on an element, while still showing inheritance so visitors understand the taxonomy. The URL stays live for cross-linking.

Each row carries required_parent and required_child arrays. The template renders both as link clusters pointing at the matching /aria-role/{slug}/ pages, so a visitor on tab can jump to tablist and see how the two roles fit together.

States and properties are first-class rows in their own dataset and listed on role pages by reference. SleekRank can render both with one slug pattern, like /aria-role/ for roles and /aria-state/ for states, with cross-links built from the role row data.

The dataset lives in the repo. When a new ARIA spec ships, a script re-parses the taxonomy and updates rows. The diff goes through pull request review, and a SleekRank sync rolls it live. The site tracks the spec without per-page editing.

Yes. Each role row can include implicit_element_map entries linking to /html-element/{slug}/ pages. The template renders that map prominently, so visitors on dialog see the link to the matching HTML element dialog without manual cross-linking.

Yes. Add a status field with values like stable, deprecated or proposed. The template renders the status as a badge, and the index page can filter on it. Experimental roles stay clearly marked rather than blending in with stable roles.

Each row can include a screen_readers object with notes per screen reader, like NVDA, JAWS and VoiceOver. The template renders that object as a compatibility table near the bottom of the page, so accessibility engineers see real-world support alongside the spec definition.