diff --git a/README.md b/README.md index 6e1959fdb..8c6cf037f 100644 --- a/README.md +++ b/README.md @@ -231,6 +231,49 @@ The ARIA repositories share a common set of resources to reduce redundancy. Shar Todo: special characteristics table classes etc. used by the script +### Assistive Technology Implementation Guidance + +The ARIA specification includes optional Assistive Technology (AT) guidance sections for roles, states, and properties that require implementation guidance beyond the normative accessibility API mappings. These sections provide implementation recommendations specifically for assistive technology developers. + +#### When to Add AT Guidance + +AT guidance should be added when: + +1. **Complex user interaction patterns** - When a role or state involves multi-step interactions or complex navigation patterns +2. **Implementation variations** - When different assistive technologies might reasonably implement features differently +3. **User experience considerations** - When specific UX patterns would benefit users with disabilities +4. **Platform-specific behavior** - When behavior should differ across platforms (desktop, mobile, web) +5. **Common implementation mistakes** - When implementers frequently make specific errors that impact usability + +#### Structure and Content Requirements + +AT guidance sections should: + +1. **Use proper heading hierarchy** - Main section header should be `
General guidance that applies to all assistive technologies...
+ +Specific guidance for screen reader implementation...
+ +Specific guidance for voice control software...
+