Skip to content

📚 Documentation: Social Icon Labels need improving [a11y][TheA11y100] #281

@GrahamTheDevRel

Description

@GrahamTheDevRel

Issue

The icons for socials in the footer are incorrectly labelled as "Appwrite on aw-icon-discord".

Discord icon in footer highlighted with corresponding element shown in dev tools, aria-label shows "Appwrite on aw-icon-discord" instead of "Discord"

Why it matters

People navigating via assistive tech such as a screen reader or via voice control (i.e. Dragon Natural Speaking) may be confused by the label.

Suggested fix

Update the label to read as "Discord", "GitHub", "X App" etc.

Important note: Just use the name of the social, without "Appwrite". This can make navigation via voice a lot easier as they may use a command "click button discord" for example and this may not always function correctly if it starts with the text "Appwrite".

Relevant Success Criterion WCAG

Link Purpose (In Context)

Additional Notes

On stream it was mentioned that this has a fallback mechanism, so the fallback mechanism may also need updating or improving to avoid this issue in the future. Up to Appwrite to advise.

Found on stream on 2023-10-25

@jasonetorres was interested in fixing this one.

👀 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 documentationgood first issueGood for newcomers

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions