From cdf81d1ee36f31777576a896da95b8e0bad378d1 Mon Sep 17 00:00:00 2001
From: Josh Creek <8179928+jcreek@users.noreply.github.com>
Date: Sun, 27 Apr 2025 22:36:13 +0100
Subject: [PATCH] docs(*): Add accessibility docs

---
 docs/accessibility.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 docs/accessibility.md

diff --git a/docs/accessibility.md b/docs/accessibility.md
new file mode 100644
index 0000000..cfeec22
--- /dev/null
+++ b/docs/accessibility.md
@@ -0,0 +1,20 @@
+# Accessibility & User Experience
+
+## Accessibility Features
+
+- All forms and buttons have proper labels and aria attributes.
+- Error messages and spinners use aria-live and roles for screen reader support.
+- Keyboard navigation is fully supported throughout the app.
+- Color contrast meets accessibility standards.
+
+## User Experience Highlights
+
+- Loading spinner and overlay during grading for instant feedback.
+- Confirmation dialogs for deleting history to prevent accidents.
+- Friendly, actionable error messages for all failure scenarios.
+- Mobile-friendly and responsive layout.
+
+## Things that could be included in an accessibility demo
+
+- Tab through the UI to show keyboard accessibility.
+- Use a screen reader to announce errors and loading states.