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

New docs website has some accessibility issues #270

Open
amellnik opened this issue Jul 14, 2024 · 2 comments
Open

New docs website has some accessibility issues #270

amellnik opened this issue Jul 14, 2024 · 2 comments

Comments

@amellnik
Copy link

I noticed that the text in the header is very difficult to read due to the low contrast and ran it through a basic a11y tester (axe devtools). Many of these may have also existed in the previous version.

There's two things which would be very easy to fix:

  • A few elements with insufficient contrast
  • Links are not distinguished except by color

Some other issues which are slightly more involved to fix:

  • Deprecated aria roles stemming from sphinx (doc-biblioentry, doc-backlist)
  • Search area includes a scroll wrap even when there's thing possible to scroll
@amellnik
Copy link
Author

Some of this is likely addressed by #269.

@ZacBlanco
Copy link
Contributor

@amellnik Can you provide a more specific report? We can work on some items before the next release, but currently the issue description is too vague to take any actions.

We can control some basic things like some colors on the theme, but there are probably others items which are issues on the base theme (sphinx-immaterial) that we don't have control over. They might be better suited as issues filed on the theme's repository: https://github.com/jbms/sphinx-immaterial/

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

No branches or pull requests

2 participants