Development record
adr-47 decision 2's allowlist of generator-added words does not name image alt text, yet the migrated docs pages carry alt text the site inherits; the carve-out wants an explicit ADR amendment
adr-47 decision 2's allowlist of generator-added words does not name image alt text, yet the migrated docs pages carry alt text the site inherits; the carve-out wants an explicit ADR amendment
Remedy grounds (2026-09-29)
SOTA check: WCAG 2.2 technique H37 (https://www.w3.org/WAI/WCAG22/Techniques/html/H37, read 2026-09-29) says alt text must convey the image's meaning in context, and the W3C alt decision tree (https://www.w3.org/WAI/tutorials/images/decision-tree/, read 2026-09-29) gives decorative images an empty alt; both put alt text with the page author, which is where decision 2 already sources it (internal/core/site/assets.go renders the docs page's own alt). Rejected: generated alt text, which decision 2 forbids and H37 would not accept as meaning.
Frontmatter
| id | iss-2608220750024303 |
|---|---|
| type | issue |
| lifecycle | open |
| severity | minor |
.abcd/work/issues/open/iss-2608220750024303-adr-47-decision-2-s-allowlist-of.md
open on GitHub ↗ · commit history ↗
mentions1
- adr-47abcdev.app is rendered from this repository alone