Skip to content

Commit

Permalink
doc: underline links
Browse files Browse the repository at this point in the history
The current use of color only to differentiate links fails WCAG A
accessibility standards.

Possible solutions are:

1. Using a text indicator to show that the text is a link.
2. Using additional cues (such as underlining)
3. Providing color contrast of 3:1 or greater with surrounding text
   (not the background--the adjacent text!) along with visual cues
   on hover.

The solution here implements the second option.

Ref: https://www.w3.org/WAI/WCAG21/Understanding/use-of-color.html
Ref: https://www.w3.org/WAI/WCAG21/Techniques/failures/F73
Ref: https://www.w3.org/WAI/WCAG21/Techniques/general/G182
  • Loading branch information
Trott committed Oct 30, 2023
1 parent dcaded0 commit be33bb1
Showing 1 changed file with 0 additions and 1 deletion.
1 change: 0 additions & 1 deletion doc/api_assets/style.css
Original file line number Diff line number Diff line change
Expand Up @@ -136,7 +136,6 @@ a:link,
a:active,
a:visited {
color: var(--color-links);
text-decoration: none;
border-radius: 2px;
padding: 1px 3px;
}
Expand Down

0 comments on commit be33bb1

Please sign in to comment.