search

swiftlang / swift-book

The Swift Programming Language book
Apache License 2.0
1.76k stars 162 forks source link

Add alt text to figures #13

Open swift-ci opened 3 years ago

swift-ci commented 3 years ago
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.

typesanitizer commented 3 years ago

@swift-ci create

Nitya-Pasrija commented 2 years ago

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

image Also, we are talking about these images right?

krilnon commented 2 years ago

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.)

amartini51 commented 1 year ago

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