This documents will go over several of the different methods and standards used to make written documentation as accessible as possible.
When creating web content for your KB, it is important to keep in mind all audiences that may view that content. Making sure that your content is accessible to all web users ensures that anyone can view and understand your sites. Not all users interact with the web in the same way, so it is vital that your content is accessible in as many ways as possible. For more information about the importance of accessible content, take a look at Introduction to Web Accessibility.
HTML is the base structure of a page, and as such, must be correct for accessibility tools to work correct. Use an HTML Validator to check your code before publishing docs, as long as the page contains no confidential content. For more details on HTML structure you can read the WebAIM semantic structure guide.
Keep page organization as consistent as possible between articles, so that when a user goes between articles, the information is presented in a way that makes sense to them. If page layout/navigation differs between pages, it can end up in user frustration, and if a user is using something like a screen reader, only more so. Keep heading layout and link structuring as close as possible in between documents for easy navigation.
Good color contrast ensures that those with visual disabilities can use your pages. There are two standards for color contrast, AA (4.5:1) and AAA (7:1). you should target AA but AAA is nice to have. You can use a color picker browser extension and then check color combinations for compliance with the WebAIM contrast checker.
Is too descriptive, contains extraneous text (image of meaning can be conveyed in fewer words)
Bad alt text: computer coffee iced shop cold drink earbuds phone
Keyword stuffing instead of describing the image
Videos should not autoplay when embedded, so that they do not confuse and annoy users visiting your webpage. Subtitles or a transcript should also be included whenever possible so those with hearing disabilities can access your content.
String welcome = "Hello"; System.out.println(welcome);
To check pages for accessibility, you can use a tool called WAVE. In order to use it, simply put in a URL to a public page, and it will tell you any possible accessibility problems that your page might have. While you can use it at any time, it's best to write your pages for accessibility first and then check for any mistakes with the tool. Check out WAVE here.
If you want to further check your pages for accessibility, you can use the WebAIM Quick reference or the more fully-featured WCAG 2 checklist and make sure that all the elements on the page meet all of the guidelines outlined in the list. Some important ones if you're editing the styling of spaces are color contrast and font sizing. If you edit the colors of a page in a manner that does not comply with AA or AAA standards it can make the page difficult to read for someone with a visual disability. You can check for color contrast using a color contrast checker. If making use of custom CSS or forms take a look at Accessible CSS and Accessible Forms. For more UW specific policy, you can view the official DoIT Make it accessible guides.
If you want a detailed overview of web content accessibility as a whole, this presentation from Kurt Murckstadt from the 2021 KB User Group Meeting goes into far more detail. See the document Creating Accessible KB Content to follow along with the presentation.