We believe that the knowledge you need to do your job should find you. This applies to users of all cognitive and physical abilities. Here are some tips and resources we've used to make Guru as accessible as possible to everyone.
Consider the following guidelines when authoring Guru Cards to make them more accessible. Guru has many built-in tools (like formatting) that make these guidelines easy to follow.
These are built with rigid structures on purpose. Don't try to customize them.
Always left-align text to increase readability and orderliness
White space helps people skim and read better. Some ways to add more white space to increase readability include:
Add sub-headlines
Vary length of items in a list
Vary sentence lengths
Use proper punctuation (built-in white space)
Avoid the following when possible:
Underlined text (implies a link)
Colored text
All-caps text
"Clutter marks" (colon, semi-colon, hyphen), which imply "heavy reading ahead"
Creating content that's perceivable by everyone is one of the core principles of accessible writing. This means that information should be presented in ways that make it possible for everyone to see, hear, or otherwise perceive, regardless of a disabilities.
If important information is only presented in non-text formats, consider how someone with a disability would access it
Avoid using emojis to portray meaning that isn't otherwise identified (for example, don't use the Slack logo emoji in place of the word "Slack"—put them side-by-side, if you really need the emoji
Use descriptive text to link to other places
Any link with the text "click here" is automatically inaccessible
Any time-based media might need additional accessibility supplements
For example, a recording with a transcription of a live webinar
Creating content that can be read and understood by the intended audience is another core principle of accessible writing.
Always write in plain language. A good test is: "could a 13-year-old easily read, understand, and use this information?"
Be predictable. Keep items in the same order, avoid switching between words that mean the same thing (i.e. "knowledge" vs. "information"), and start Cards with a summary where necessary.
Overall, we should always be aiming to make writing clear, predictable, and accessible to everyone—regardless of disability.
Plain Language: How to Simplify Content for a Better Reader Experience
The font we use in our Guru application is accessible. We use Proxima Nova which is one of the better fonts for accessibility due to it having a lower stroke contrast. Our Design Team has been working to make sure the color palette is accessible as well. Many of those updates have been rolled out to the app and the extension.
Accessibility best practices influence both our language and design in our product and on our website. This may include edits to colors, copy, UI, and more. We're in the process of completing an ADA Audit that will give us a better picture of areas we need to address. The aim is to bring the application up to Level AA compliance as set by WCAG 2.1 Success Criteria.
These tips are curated for Guru from Contented's Certificate in Accessible Writing course.
Guru specifically disclaims any liability with respect to this document, your ability or inability to access this product, or your use of this product, and no contractual obligations are formed either directly or indirectly by this document or your access, inability to access or use of this product.