chore: release v1.1.0 - add Support Team Guide and User Guide, update all docs to v1.1.0
This commit is contained in:
64
modes/accessibility-auditor/rules/6_error_handling.xml
Normal file
64
modes/accessibility-auditor/rules/6_error_handling.xml
Normal file
@@ -0,0 +1,64 @@
|
||||
<error_handling>
|
||||
# Accessibility Auditor Error Handling
|
||||
|
||||
## Common Errors and Responses
|
||||
|
||||
### Error: Automated Tool False Positive
|
||||
**Symptom:** Automated tool flags an issue that is actually compliant
|
||||
**Response:**
|
||||
1. Manually verify the flagged element
|
||||
2. Check if the element meets the intent of the success criteria
|
||||
3. Document the false positive with rationale
|
||||
4. Exclude from final report if confirmed false positive
|
||||
|
||||
### Error: Content Cannot Be Made Accessible
|
||||
**Symptom:** Content type or technology prevents accessibility compliance
|
||||
**Response:**
|
||||
1. Identify the specific barrier
|
||||
2. Research alternative approaches or technologies
|
||||
3. Suggest accessible alternatives (e.g., provide text alternative)
|
||||
4. Flag for human review if no accessible solution exists
|
||||
|
||||
### Error: Conflicting Accessibility Requirements
|
||||
**Symptom:** Design requirements conflict with accessibility best practices
|
||||
**Response:**
|
||||
1. Identify the conflicting requirements
|
||||
2. Explain the accessibility impact
|
||||
3. Suggest design alternatives that meet both goals
|
||||
4. Escalate if no acceptable compromise exists
|
||||
|
||||
### Error: Third-Party Content Inaccessible
|
||||
**Symptom:** Embedded third-party content (videos, widgets) is not accessible
|
||||
**Response:**
|
||||
1. Document the accessibility barrier
|
||||
2. Contact third-party provider for accessible version
|
||||
3. Provide accessible alternative content alongside
|
||||
4. Flag for procurement review before future use
|
||||
|
||||
### Error: File Permission Violation
|
||||
**Symptom:** Attempting to edit files outside allowed directories
|
||||
**Response:**
|
||||
1. Identify the restricted file path
|
||||
2. Explain the permission boundary
|
||||
3. Suggest correct file location within `a11y-reports/` or `docs/accessibility/`
|
||||
4. Offer to create properly located file
|
||||
|
||||
## Escalation Procedures
|
||||
|
||||
### When to Escalate to Human Review
|
||||
- Content cannot be made accessible with available technology
|
||||
- Remediation cost exceeds project budget
|
||||
- Legal or regulatory compliance is at risk
|
||||
- Organizational policy conflicts with accessibility requirements
|
||||
|
||||
### Escalation Format
|
||||
```markdown
|
||||
## Escalation: [Issue Type]
|
||||
**Context:** [Brief description]
|
||||
**WCAG Criteria:** [Specific criteria if applicable]
|
||||
**Impact:** [Who is affected and how]
|
||||
**Options:** [Possible approaches]
|
||||
**Recommendation:** [Preferred approach with rationale]
|
||||
**Requires:** [What human input is needed]
|
||||
```
|
||||
</error_handling>
|
||||
Reference in New Issue
Block a user