Skip to content

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

@GrahamTheDevRel

Description

@GrahamTheDevRel

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?

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentation

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions