diff --git a/.cspellignore b/.cspellignore index ce5217a10b..67ca8d06c4 100644 --- a/.cspellignore +++ b/.cspellignore @@ -64,4 +64,5 @@ timestamptz formatjs autoplay authproxy -xact \ No newline at end of file +xact +WCAG diff --git a/docs/docs/9-coding-guidelines/13-accessibility.md b/docs/docs/9-coding-guidelines/13-accessibility.md new file mode 100644 index 0000000000..87d0b5dad0 --- /dev/null +++ b/docs/docs/9-coding-guidelines/13-accessibility.md @@ -0,0 +1,21 @@ +--- +title: Accessibility +--- + +Comet projects aim to conform to [WCAG 2.1 Level AA](https://www.w3.org/TR/WCAG21/). + +## POUR Principles + +- **Perceivable:** Provide text alternatives, captions, and sufficient contrast. +- **Operable:** All functionality must be keyboard accessible. +- **Understandable:** Use predictable behavior, clear instructions, and helpful error messages. +- **Robust:** Ensure content works with a wide range of devices and assistive technologies. + +## Key Rules + +- Use semantic HTML (`