Skip to content

Replace color-only wiring/circuit instructions with redundant cues (a11y, WCAG 1.4.1) #111

Open

Description

@jonfroehlich

Color-only wiring/circuit instructions (accessibility)

The V2.0 accessibility audit flagged color-only instructions in some wiring/circuit explanations — e.g. "connect the red wire to 5V and the black wire to ground" or diagrams that distinguish components by color alone. This fails WCAG 1.4.1 (Use of Color): users with color vision deficiency (or grayscale/printed copies) can't follow them.

Unlike the mechanical sweep in #110 (iframe title=, video aria-label, image alt), this needs content edits and isn't auto-detectable, so it's tracked separately.

What to do

  • Audit wiring instructions and circuit diagrams for color-only cues.
  • Add a redundant non-color cue: pin/row labels, position ("top rail"), shape, or text annotations alongside color.
  • Prefer phrasing like "the red (positive) wire to 5V" so color is supplementary, not the sole signal.

Likely worst offenders (from the audit): electronics, cpx, sensors wiring sections. Needs a manual pass.

Part of V2.0.

Activity

  1. added
    contentLesson content: errata, corrections, new sections, pedagogy
    v2.0Targeted for the Version 2.0 release
    accessibilityAccessibility (a11y): alt text, ARIA, contrast, keyboard/screen-reader support
    on Jun 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    accessibilityAccessibility (a11y): alt text, ARIA, contrast, keyboard/screen-reader supportcontentLesson content: errata, corrections, new sections, pedagogyv2.0Targeted for the Version 2.0 release

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions