swift-book icon indicating copy to clipboard operation
swift-book copied to clipboard

Add alt text to figures

Open swift-ci opened this issue 3 years ago • 4 comments

Previous ID SR-14465
Radar rdar://problem/76466123
Original Reporter amos (JIRA User)
Type Bug

Environment

Any web browser

Additional Detail from JIRA
Votes 0
Component/s
Labels Bug, Documentation
Assignee None
Priority Medium

md5: 636d25b780d6f98d27615d54de6badbd

Issue Description:

Many images in the language guide on docs.swift.org are missing meaningful alt text. Please fix so people using screen readers can fully experience the docs.

For example: in the strings and characters section, the image illustrating handling of indentation in multi-line strings has the image path as its alt text.

swift-ci avatar Apr 09 '21 19:04 swift-ci

@swift-ci create

typesanitizer avatar Apr 09 '21 19:04 typesanitizer

Heya, I would love to work on this issue. Can you assign it to me?

image Also, we are talking about these images right?

Nitya-Pasrija avatar Aug 07 '22 18:08 Nitya-Pasrija

Hey @Nitya-Pasrija, yes, these images need descriptions. If you're still interested in working on this; a PR is welcome! I'm interested as well, so feel free to tag me in discussions. (For context, I think one of our early publication systems didn't propagate image descriptions to the rendered book, so these have been missing for a while.)

krilnon avatar Aug 30 '22 18:08 krilnon

Started adding alt text on a branch: https://github.com/amartini51/swift-book/tree/alt_text_76466123

amartini51 avatar Aug 03 '23 22:08 amartini51