diff --git a/accessibility-guide.md b/accessibility-guide.md new file mode 100644 index 0000000..cef9fed --- /dev/null +++ b/accessibility-guide.md @@ -0,0 +1,466 @@ + +--- Guide for accessibility --- +# Accessibility Coding Guidelines + +This guide provides actionable DOs and DON'Ts for AI coding agents to ensure web applications are accessible to all users, including those using assistive technologies. + +Keep these principles in mind throughout: + +- **Accessibility is the minimum, not the ceiling.** Conformance to standards is the floor; aim for genuine usability. +- **Patterns are use-case specific.** No checklist replaces real testing — including testing with disabled users — to confirm a given implementation is actually accessible in context. + +## 1. Content Navigability and Structure + +### Actionable Guidelines + +#### DOs +- **Place all content within landmarks**: Wrap the page in `
`, `