Most unexplained diagrams I saw were ones which mirrored classic computer-science imagery;
these diagrams, for the most part, were not complex nor exotic;
they are straight-forward to explain in writing,
or easy to turn into a table.
I'll show two examples here,
one will show a visual aide in relation to stacks and queues,
and the other will show a memory representation of a stack.
Both of these were explained as "image" to the student.
## Stacks
Diagram 1:
<figure>
<imgsrc="/assets/img/access1/stack.png"alt="image...lol! Just kidding, will explain it below w/ table">
<figcaption>Simple diagram explaining the push/pop process. Source: <ahref="https://stackoverflow.com/questions/32151392/stacks-queues-and-linked-lists">Stackoverflow</a></figcaption>
</figure>
Ok, so here we have a diagram showing the pushing and popping process of a stack.
Now, "image" is hardly sufficient to explain this, so let's try it with text.
I won't finish it because it gets unwieldy very fast:
> A diagram showing a stack. It starts with the operation "Push A", and now the stack contains the variable "A"; now the stack pushes "B", which displays now "B" on top of "A"...
This is no solution.
It is hard to explain this correctly and accurately without being extremely verbose and frankly, confusing---this defeats the whole purpose of describing the image.
The good news, is that computer science diagrams especially tend to lean towards being tabular data.
Now to be clear, something does not need to look like a table to be tabular data;
this image happens to look almost like a table if you squinted hard enough,
but many data not written down in a table, are still "tabular data".
I will show an example of that next!
For now though, here is the same idea, same data without words:
Here is what I get by extracting the text from the PDF:
<pre>
B2U(X ) =
w-1
Σ xi •2
i=0
i
</pre>
And this is generous, as the sigma sign, bullet point, equal sign and minus sign were for some reason not UTF-8 encoded so it displayed as a chat sign emoji, down arrow, video camera and book sign respectively.
Not sure about you, but I certainly can't get the equation out of that mess.
These can be written in LaTeX, then converted to MathML (an accessible math format) using [KaTeX](https://katex.org).
Here's an example of what to write to product the function above:
For someone who is doing transcription as a *job* for visually impaired students,
I would go so far as to say to learn this is a necessity.
1. It's not difficult. You can learn the vast majority of LaTeX math syntax in an afternoon.
2. It's easier for *everyone* to read. Especially with KaTeX. KaTeX is able to convert the formula to both MathML for screenreader users and HTML markup for people who just want to see those fancy math expressions.
Likely, the teacher is already using some LaTeX derivative to create the math in the first place,
they might as well use a program like KaTeX, MathJax or likewise to convert it to MathML.
## Code & Output
How did it even happen that entire programs and outputs were just ignored with the label "picture of output" is beyond me.
Everything should be transcribed.
Whoever transcribed that document should be fired.
## Conclusion
To teachers:
Presenting information in plain text, or at least having alternates forms of images, diagrams and math formulas makes education better for everyone, not just blind students.
It makes it better for people running on cheaper devices which may not handle running heavy software like Microsoft PowerPoint;
it makes it better for people who use operating systems other than MacOS and Windows (this is especially important in the technology sector, where Linux/BSD users make up a sizeable minority of users);
and finally, it makes it easier to search through the content of all notes at once using simple text-manipulation tools.
To accessibility departments:
Running a `pdftotext` program, or simply transcribing handwritten notes is not enough to properly describe slides and notes---handwritten or not.
Every diagram, math equation, annotation, piece of code or output---every single thing must be transcribed to plain text, or some alternate format like MathML.
I find it sad that a student (with their own full-time job) can product better work than someone who has this job exclusively at a major university.
Perhaps I am mistaken and the university has volunteers do this work.
In that case I guess you can't ask for too much, but somehow I feel like this is probably not the case.