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鈥檒l occasionally send you account related emails.

Already on GitHub? Sign in to your account

馃摎 Documentation: Buttons on docs homepage need better alt text[a11y][TheA11y100] #295

Open
2 tasks done
GrahamTheDevRel opened this issue Oct 26, 2023 · 3 comments
Open
2 tasks done
Assignees
Labels
documentation Improvements or additions to documentation

Comments

@GrahamTheDevRel
Copy link

GrahamTheDevRel commented Oct 26, 2023

Issue

On the docs homepage the buttons (links) for each framework / technology provide text for the links using the alt tag on the images inside. The alt descriptions currently describe the image, rather than the link purpose.

screenshot of flutter button with the image highlighted showing alt text of "flutter logo"

Why it matters

When using an image alt attribute as the text within a link, it is important that the alt text is descriptive of the link purpose so that people using assistive technology know where the link will take them, rather than what the image is of.

Otherwise this can be confusing as to the purpose of the link when it is announced (i.e. in a screen reader would "flutter logo" take me to a larger picture of the flutter logo or to the page on flutter).

Suggested fix

Remove "logo" from the alt text on all images in this section.

Better alt text would be "Flutter quick start", "Next quick start" etc. as that is more descriptive of the destination.

Relevant Success Criterion WCAG

Link Purpose (In Context)

Additional Notes

Good first issue.

Found on stream on 2023-10-25

馃憖 Have you spent some time to check if this issue has been raised before?

  • I checked and didn't find similar issue

馃彚 Have you read the Code of Conduct?

@GrahamTheDevRel GrahamTheDevRel added the documentation Improvements or additions to documentation label Oct 26, 2023
@divyanshkul
Copy link

Can I work on this? Could the hacktoberfest label be added to this?

@harshi706
Copy link

Can you assign this issue to me

@TGlide
Copy link
Contributor

TGlide commented Oct 30, 2023

Can I work on this? Could the hacktoberfest label be added to this?

Assigned! And we can add the hacktoberfest-approved label to the PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

4 participants