Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Add alt text to figures #13

Open
swift-ci opened this issue Apr 9, 2021 · 4 comments
Open

Add alt text to figures #13

swift-ci opened this issue Apr 9, 2021 · 4 comments
Labels
Content issue A problem in with the book's prose, code, or figures Good first issue Work that's well-suited for new contributors

Comments

@swift-ci
Copy link

swift-ci commented Apr 9, 2021

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
Copy link

@swift-ci create

@swift-ci swift-ci transferred this issue from apple/swift-issues Apr 25, 2022
@Nitya-Pasrija
Copy link

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 krilnon transferred this issue from apple/swift Aug 30, 2022
@krilnon
Copy link
Member

krilnon commented Aug 30, 2022

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 amartini51 removed Build issue A problem or enhancement in the tools that build and publish this book Content issue A problem in with the book's prose, code, or figures labels Aug 31, 2022
@amartini51 amartini51 changed the title [SR-14465] Many images in language guide do not have alt text Add alt text to figures Sep 1, 2022
@amartini51 amartini51 added Content issue A problem in with the book's prose, code, or figures Good first issue Work that's well-suited for new contributors labels Oct 10, 2022
@amartini51
Copy link
Collaborator

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
Content issue A problem in with the book's prose, code, or figures Good first issue Work that's well-suited for new contributors
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
5 participants
@krilnon @typesanitizer @swift-ci @amartini51 @Nitya-Pasrija