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

Accessibility #64

Open
soetz opened this issue Jan 8, 2022 · 0 comments
Open

Accessibility #64

soetz opened this issue Jan 8, 2022 · 0 comments
Labels
bug Something isn't working

Comments

@soetz
Copy link
Contributor

soetz commented Jan 8, 2022

Describe the bug
I noticed a few accessibility issues while translating the docs to French (#63). They’re clearly not critical, but they’re still issues.

Here’s a list:

  • There are a few jumps in heading levels, which is not very assistive technology-friendly. Example: https://axios-http.com/docs/urlencoded
  • Related, I’m not 100% sure about this but I think having several consecutive headings without content in-between is an anti-pattern (a user using assistive technology would jump to the heading and expect there to be content). Example: https://axios-http.com/docs/api_intro
  • From what I’ve seen, all clickable elements are keyboard-focusable, which is good, but the focus indicator is not always very visible, when there is any. At least on Firefox.
  • The > text here Markdown blocks should probably translate to <aside> elements instead of <blockquote> because they are never used to indicate citations and aside is more semantic in this context.
  • The text contrast is not WCAG-compliant for a lot of elements, though some of them seem ok to me in reality (the WCAG color contrast algorithm is not perfect (yet)).
@soetz soetz added the bug Something isn't working label Jan 8, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug Something isn't working
Projects
None yet
Development

No branches or pull requests

1 participant