Merge PR #560: deploy/gitea-a11y/README.md

deploy/gitea-a11y/README.md

@@ -1,21 +1,64 @@
-# Gitea Accessibility Fix - R4: Time Elements
+# Gitea Accessibility Fixes
 
-WCAG 1.3.1: Relative timestamps lack machine-readable fallbacks.
+Custom template overrides for WCAG 2.1 AA compliance on the Timmy Foundation Forge.
 
-## Fix
+Applied fixes identified by the accessibility audit (#492):
 
-Wrap relative timestamps in `<time datetime="...">` elements.
+| Fix | Issue | WCAG | Description |
+|-----|-------|------|-------------|
+| R1 | #551 | Best Practice | Password visibility toggle (eye icon) on sign-in page |
+| R2 | #552 | 3.3.1 | `aria-required="true"` on required form fields |
+| R3 | #553 | 4.1.2 | `aria-label` on star/fork count links ("2 stars", "0 forks") |
+| R4 | #554 | 1.3.1 | `<time datetime="...">` elements for relative timestamps |
 
-## Files
+## Structure
 
-- `custom/templates/custom/time_relative.tmpl` - Reusable `<time>` helper
-- `custom/templates/repo/list_a11y.tmpl` - Explore/Repos list override
+```
+deploy/gitea-a11y/
+├── deploy-gitea-a11y.sh          # Deployment script
+├── README.md
+└── custom/
+    ├── public/
+    │   ├── css/
+    │   └── js/
+    └── templates/
+        ├── custom/
+        │   └── time_relative.tmpl    # R4: <time> helper
+        ├── repo/
+        │   └── list_a11y.tmpl        # R3: aria-label on counts
+        └── user/auth/
+            └── signin_inner.tmpl     # R1+R2: password toggle + aria-required
+```
 
 ## Deploy
 
 ```bash
-cp -r custom/templates/* /path/to/gitea/custom/templates/
-systemctl restart gitea
+bash deploy/gitea-a11y/deploy-gitea-a11y.sh
+# or to a specific host:
+bash deploy/gitea-a11y/deploy-gitea-a11y.sh root@my-gitea-host.com
 ```
 
-Closes #554
+## Template Overrides
+
+Gitea supports custom template overrides by placing files in `custom/templates/`.
+The templates here override the default Gitea templates with a11y improvements.
+
+### R1: Password Visibility Toggle
+
+Adds an eye icon (👁) button next to the password field that toggles between
+`type="password"` and `type="text"`. Updates `aria-label` dynamically.
+
+### R2: aria-required
+
+Adds `aria-required="true"` to the username and password inputs, which
+properly communicates required state to screen readers.
+
+### R3: Star/Fork aria-label
+
+Wraps star and fork count links with `aria-label="2 stars"` so screen
+readers announce the meaning, not just the number.
+
+### R4: `<time>` Elements
+
+Wraps relative timestamps ("2 minutes ago") in `<time datetime="2026-04-13T17:00:00Z">`
+providing both human-readable text and machine-readable ISO 8601 dates.