rust-lang / rust-lang/rust-clippy

Accessibility Report of the Clippy Lints page

Open
#15,604 6 comments 0 reactions 1 assignee View on GitHub

@GuillaumeGomez is already working on this.

Since Sep 19, 2025.

A-website C-an-interesting-project
Dominant language
Rust
Stars
13.5k
Forks
2.2k
Avg merge
2d 10h
Merged PRs (30d)
32

Description

I just ran WAVE over https://rust-lang.github.io/rust-clippy/master/index.html to see how it fared. Here's the report

There are a bunch of errors and alerts. They are down below, in order of importance:

The 4 Errors

  • theme-choice has no label
  • The 3 version-filter-selector items have no label

The lack of labels (especially in the version filter selector) mean that understanding and using that form's item using a screen reader might require contorting over the surrounding elements to figure out what meaning and role each unlabeled form element has.

The 1585 Contrast Errors

These are due to poor contrast, mostly between text and background color, in the elements of the page. This metric is derived from the W3C's work, and such low contrast becomes an issue for any user with impaired vision.

The large majority of these errors are the group labels:

Two textblocks: one dark gray with white text, reading 'complexity'. The other, a warm orange with white text, reading 'warn' for warning

White text over colored blocks needs extremely strong contrast to be legible; that's why this is considered an issue.

This however can be fixed right away with a different default Theme; one that gives more contrast by default.

The 1621 Alerts

There are 3 alerts related to the 3 version filter selectors, which will disappear as soon as those errors are addressed.

There are a couple of alerts related to heuristics that aren't always indicative of issues, like "Redundant Link" or having a youtube video (these are explained in detail in the report).

The rest are mostly separated into two groups.

Small Text

Most of the Alerts are about text that is considered to be bordering on "too small" for users with any kind of visual impairment.

Structural Issues

A couple of the remaining Alerts are related to things like having no Page Regions and having noscript elements, both of which impair the work of assistive technologies.


I hope this linting of Clippy's index of lints is useful.

I wanted to see how I could fix some of the errors, but currently my time is very limited so I'd better just post the report and hope that someone with more familiarity with this page can address them.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.