I'm writing a technical blog post and want to use a UML sequence diagram to explain something.
Only trouble is, I have no idea how to make such a diagram accessible to a screen reader.
I know I could just write up alt-text to describe it, but at that point I feel like I should just use the text _instead_ of the diagram.
Maybe that's the answer, but I'm hoping there's a way to get a screen reader to communicate the diagram in some way?
Any ideas appreciated!

André Polykanine
in reply to ragman • • •ragman
in reply to André Polykanine • • •@menelion PlantUML looks neat!
I'm currently using js-sequence-diagrams[1], which looks like it has similar syntax as PlantUML.
Putting the code/text representation of the diagram feels like it'd be helpful for a small diagram, but maybe too much to keep in ones head for a larger one?
Better than nothing I reckon though!
1) bramp.github.io/js-sequence-di…
js-sequence-diagrams by bramp
bramp.github.ioAndré Polykanine
in reply to ragman • • •Why am I saying this? Because it's not even better than nothing, it's quite enough for a technically or scientifically inclined person to decipher what you're saying. I'm not proficient in this at all (JS-Sequence-Diagrams looks also good, also there's Mermaid supported by GitHub, I think) but if I need or want it, I'll read the docs and cope with it. Or… drop you a message and ask for help 😊
Anyway, thank you so much. It's really heartwarming.
ragman
in reply to André Polykanine • • •@menelion Aww thank you André. ❤️ I'm touched, and not really sure how to respond!
I guess I'll just say that I want to live in the world where we all look out for each other's needs, and where we can ask each other for accommodations or help when we need to. Where we all get those warm breezes when we're cold :)
Anyway, thank you again for the kind words!
ragman
in reply to André Polykanine • • •@menelion On the PlantUML front, I found this paper describing how it was used in a computer science class to help a blind student learn the content:
dl.acm.org/doi/pdf/10.1145/354…
Some points I found interesting:
* the textual representation of the diagram was enough for, at least this one person, to be able to follow along in the course
(1/2)
André Polykanine
in reply to ragman • • •Artyom Bologov
in reply to ragman • • •André Polykanine
in reply to Artyom Bologov • • •ragman
in reply to André Polykanine • • •@menelion @aartaka Thank you both!
I think I'm going to give PlantUML a shot for this, since it seems to have a few more features than Mermaid, and should work well with my static site generator set up.
I'll write a blog post about it and report back in a little while :D
André Polykanine
in reply to ragman • • •ragman
in reply to André Polykanine • • •@menelion @aartaka
I will!