---
title: Accessibility checks
description: Accessibility-oriented checks and handoff guidance for documentation work.
---

# Accessibility checks

Use these checks for documentation content that is authored or reviewed by the
Documentation agent.

## Inline checks

- Ensure images and diagrams have meaningful alt text or descriptive context.
- Preserve heading order and avoid skipping levels without reason.
- Use descriptive link text rather than generic phrases like "click here".
- Provide table headers for data tables and keep the structure logical.
- Prefer plain language and short sentences where practical.
- Avoid relying on color alone to convey meaning in Mermaid diagrams or other visuals.

## Handoff trigger

If the task involves a formal accessibility assessment, user-impacting accessibility
review, or a substantive accessibility decision, route the work to the Accessibility
Planner rather than resolving the issue inline.
