📚 Documentation: Buttons on docs homepage need better alt text[a11y][TheA11y100] #295
Open
2 tasks done
Labels
documentation
Improvements or additions to documentation
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. Thealt
descriptions currently describe the image, rather than the link purpose.Why it matters
When using an image
alt
attribute as the text within a link, it is important that thealt
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?
🏢 Have you read the Code of Conduct?
The text was updated successfully, but these errors were encountered: