Accessibility Tips & Resources for Creating Guru Cards
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.
General text formatting guidelines
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.
- Use pre-built text formatting (H1, paragraph, numbered lists, etc.) when possible
- Structure Card headings correctly to improve content navigation and accessibility for all users.
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:
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)
"Clutter marks" (colon, semi-colon, hyphen), which imply "heavy reading ahead"
Creating perceivable content
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.
- Provide text alternatives for any non-text content (for example, alt text for images or a detailed caption for a video in a Card)
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 understandable content
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.
- Make sure Call to Action (CTA) buttons are extremely clear, so users know where they are going next
Overall, we should always be aiming to make writing clear, predictable, and accessible to everyone—regardless of disability.
- 7 guidelines for writing accessible microcopy
- Structuring Card Headings
- Adding Alt Descriptions (Alt Text)
Is the font you use in guru accessible?
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.
how is accessibility prioritized in guru's product roadmap?
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.
More about guru and accessibility:
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.