Web A11y Authoring

Core Rules

For concrete markup patterns, see PATTERNS.md.

1. Prefer native HTML controls before ARIA or custom widgets.
2. Use links for navigation and buttons for actions.
3. Ensure every interactive control has a clear accessible name.
4. Keep DOM order aligned with reading and interaction order.
5. Preserve visible focus and keyboard operation for every interaction.
6. Use ARIA only to supplement semantics that cannot be expressed natively.
7. Classify images, icons, and SVG as decorative, informative, or functional.
8. Communicate unusual link behavior before activation.

Authoring Checklist

Authoring checklist