# Accessibility Notes (Ethereum Interactive Lecture)

Owner: instructor / author
Reference: ../../prd.json story D10

This document inventories the accessibility decisions for the lecture and points to where each is implemented.

### Category 1: Alt-text strategy for diagrams

Decision: Every figure and TikZ illustration in the Beamer deck has an `\altdescription{...}` macro (defined in the deck preamble) and a hand-written description in the surrounding `\begin{frame}` text. The deck does not rely on visual rendering for any pedagogical point.

Implemented in: ../slides/ethereum_interactive_lecture.tex preamble plus every figure-bearing frame.

### Category 2: Color-plus-text status indicators

Decision: Every status indicator (success, warning, error) uses BOTH a color AND a text label. Red-only or green-only status indicators are forbidden. Etherscan green-checkmarks are paraphrased in instructor speech as "transaction succeeded".

Implemented in: deck slide 16 (private vs shared chain status), deck slide 21 (hard reset checkpoint), lab guide D4 callout boxes.

### Category 3: Non-voice alternative to think-pair-share

Decision: Every think-pair-share prompt has a written-card alternative. Students who do not want to speak write the answer on a card and pass it to the instructor. The TA collects cards at minute 22 and the instructor reads three samples aloud.

Implemented in: D6 timing sheet Act 2 (minute 12 to 22), deck slide 8 (TPS prompt with card alternative footnote).

### Category 4: German glossary for non-native English speakers

Decision: The lab guide ships a German glossary appendix with at least 12 terms. Slides also include a "Vocab" footnote line on the relevant frames.

Implemented in: ../lab_guide.md "Glossary (English to German)" section. Slides 6, 10, 13, 17 include vocab footnotes.

### Category 5: Large-font Solidity listing

Decision: All Solidity listings in slides use `\lstset{basicstyle=\large\ttfamily}` for code blocks (overriding the deck-wide `\tiny` for L13's lstlisting), so the code is readable from the back of a 20-seat classroom on a 1080p projector.

Implemented in: deck slide 18 (HelloWorld code), deck slide 23 (Remix interaction).

### Category 6: Screen-reader reading order

Decision: The deck uses Beamer's `\hypersetup{pdfauthor=...,pdftitle=...}` for document metadata. Each frame's logical reading order is: title, framed concept, body, footer note. Diagrams have alt text BEFORE they appear visually so screen readers describe them in context. PDF tagged structure is enabled via the `accessibility` package where compatible.

Implemented in: deck preamble, every frame.

## Audit checklist for the slide deck

- [ ] Every `\includegraphics` has an `\altdescription{...}` macro
- [ ] Every TikZ block has a description in the surrounding text
- [ ] Every status callout has a text label, not just color
- [ ] No red-only or green-only signal
- [ ] Code listings use large font
- [ ] PDF metadata fields populated (pdftitle, pdfauthor, pdfkeywords)

## Audit checklist for the lab guide

- [ ] Glossary appendix present with 12+ terms
- [ ] No image is referenced without alt text
- [ ] Code blocks use fenced markdown with language hint for screen readers
- [ ] Headings form a valid hierarchy (no h3 without preceding h2)