From 56e8578fd654691e899a3bd56d442b2a7e32a6cb Mon Sep 17 00:00:00 2001
From: Ricky Smith <jamesricky@me.com>
Date: Thu, 12 Mar 2026 11:15:53 +0100
Subject: [PATCH] Add A11y page to Coding Guidelines

---
 .cspellignore                                 |  3 ++-
 .../9-coding-guidelines/13-accessibility.md   | 21 +++++++++++++++++++
 2 files changed, 23 insertions(+), 1 deletion(-)
 create mode 100644 docs/docs/9-coding-guidelines/13-accessibility.md

diff --git a/.cspellignore b/.cspellignore
index ce5217a10bd..67ca8d06c4c 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 00000000000..87d0b5dad0d
--- /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 (`<nav>`, `<main>`, `<button>`, `<label>`, etc.).
+- Color contrast: at least **4.5:1** for normal text, **3:1** for large text.
+- All interactive elements must be keyboard operable with visible focus indicators.
+- Images need meaningful `alt` text; use `alt=""` for decorative images.
+- Associate form inputs with `<label>` (or `aria-label` / `aria-labelledby`).
+- Respect `prefers-reduced-motion`; avoid autoplay animations for users who have requested reduced motion.