The Triaging tickets: Triage workflow documentation uses a lovely diagram, that needs accessibility improvements. Does anyone have interest or experience in diagram design / documentation accessibility, who could review this and propose changes, before we’d go ahead with opening a ticket?
Here’s the diagram:
We already have a pull request done to address basic legibility improvements: making the diagram bigger, and improving the color contrast of text: #18710. There are a number of remaining things I think might warrant other tweaks.
Image of text
Are there parts of the diagram we could convert as text content on the page? So we avoid showing the text within an image where it can’t be resized or customized.
Alt text
The current alt text, Django's ticket triage workflow
, would be a good title but it’s not really a suitable alternative for the text within the image. Per WCAG SC 1.1.1 Non-text content, we need:
All non-text content that is presented to the user has a text alternative that serves the equivalent purpose
So my question is – does the other content further down the page qualify as this text alternative? If so – is there a need to programmatically associate it with the image.
Colors perception
The diagram makes heavy use of colors to distinguish different states, which will be an issue for colorblind contributors.
My recommendation there would be to make minimal changes to keep things simple?
- Add a
stroke-dasharray="4"
to the Mergers arrows - Turn the “completed” green into a shade with different luminance.
Demo with the “status” fill set to hsl(120 100% 68% / 1)
/ #5cff5c
(combined with 30% opacity) to simplify comparison, with a preview of the grayscale result: