This is the record of an abcd-managed repository

abcdBetav0.16.2 · 2026-11-06

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

issueopenminoriss-2608220750024303

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

idiss-2608220750024303
typeissue
lifecycleopen
severityminor

mentions1