potential accessibility issue: railroad diagrams do not have alt-text

speced / bikeshed

:bike: A preprocessor for anyone writing specifications that converts source files into actual specs.

https://speced.github.io/bikeshed

Creative Commons Zero v1.0 Universal

1.08k stars 199 forks source link

potential accessibility issue: railroad diagrams do not have alt-text #1183

Open zygoloid opened 6 years ago

zygoloid commented 6 years ago

For the benefit of those using screen readers, should railroad diagrams have alt-text?

tabatkins commented 6 years ago

Obvious question is: what would it be?

I'd be happy to add an option to add one manually, but I'm not sure how I could generate one automatically.

tabatkins commented 6 years ago

Alternately, you can leverage HTML already and just put it in a figure with a figcaption - the general principle of good accessibility text is that you usually want to show it to everyone.