search

WebAssembly / spec

WebAssembly specification, reference interpreter, and test suite.
https://webassembly.github.io/spec/
Other
3.11k stars 439 forks source link

Inaccessible formatting #1608

Closed workingjubilee closed 1 year ago

workingjubilee commented 1 year ago

The way that the spec is presented in the HTML format uses enormously inaccessible pseudo-text ("MathJax") instead of characters, even where characters would suffice e.g. when presenting largely tabular-formatted data. I cannot meaningfully use highlighting, computer-assisted search, etc. It makes it actively painful to navigate, read, understand, comment on, etc. I often highlight text in order to help read it as it creates contrast, or simply to copy, paste, reslice, examine, etc. And I do not find the accessibility features provided by MathJax to be sufficient, nor do they seem to actually work meaningfully with the presentation here.

It should be noted that I can deploy all of these approaches on artifacts like the Intel Software Development Manual and ISO C Standard even though they have, in spots, very nice formatting. I have in fact read many specifications for how software should execute or datasheets on how a machine should operate, and the WebAssembly spec is exceptional amongst all of them.

rossberg commented 1 year ago

Closing as duplicate of #1515.