Workshop accessibility category: Operable

[wes-brooks]

WCAG guidelines in this category:

• Make all functionality available from a keyboard.
• Give users enough time to read and use content.
• Do not use content that causes seizures or physical reactions.
• Help users navigate and find content.
• Make it easier to use inputs other than keyboard.

[wes-brooks]

This category is about ensuring a smooth interface between the user and the page. I don't think we are in danger of ausing any seizures and there are no timed elements on the page. So this will boil down to making sure that the worshop reader works with keyboard navigation, screenreaders, etc. And making sure that site is well-organized.

The macOS built-in reader (VoiceOver) can navigate the page by these categories:

• Links
• Headings
• Form controls
• Landmarks
• Window spots

They are often cluttered with duplicate "navigation" sections, Links with repetitive name like "Anchor" (Every section header) or "copy text" (one for every code chunk). There are plenty of other inconsistent elements

[wes-brooks]

The "multiple navigation sections in the Landmarks Rotor" issue is due to there being multiple uses of <nav> elements on the page. Without changing the page layout, these could be clarified in the Landmarks Rotor by adding ARIA labels (e.g., aria-label="Main Navigation"), which will then be used as the landmark in the rotor.

[wes-brooks]

The "Anchor" links are at the section headers because there is a link hidden there that is made visible when the mouse is hovered over the header. It has the aria-label "Anchor", so this is what the rotor shows. It has the class anchorjs-link, suggesting that it is provided by some library called AnchorJS.

[wes-brooks]

Disabling Javascript turns off the anchors and the section links still work, so I thin we could do without the AnchorJS library.

The links rotor is still full of links where the text of the link isn't very informative (like "here"). That is the text that is shown by default in the rotor, and we sh