mastodon - Link to source

#blind #accessibility

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!

#Accessibility #blind
in reply to André Polykanine

mastodon - Link to source

ragman

@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.io
@André Polykanine
in reply to ragman

mastodon - Link to source

André Polykanine

First of all, let me tell you something: we appreciate every move like this. You know, every blind person struggles. They may tell you it's fine, we're good, someone will even say "I'm proud to be blind" (sic!), but… we struggle. And if a person comes and tells like: "I'm posting a diagram, I want it to be seen by my blind readers" — woosh, like a wave of warm air in a cold winter street.
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.
in reply to André Polykanine

mastodon - Link to source

ragman

@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!

@André Polykanine
in reply to André Polykanine

mastodon - Link to source

ragman

@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
⇧