Skip to content

Best practices for creating accessible content

nannanli edited this page Sep 28, 2021 · 1 revision

This page is for identifying best practices when developing our content, so that we can reduce our testing effort and ensure compliance for our documentation. Please add to this page as you run into items in your testing process that might help the rest of the community.

Make images, graphics, audio, and video accessible

Provide alternative text for meaningful images and visual data

  • Alt text for an image must match what is used in the UI (ex. icons).
  • If you have an image of text (flow diagram, screen capture), then you MUST have a text equivalent. This text equivalent can be in the form of alt text, a long description, or text surrounding the image in the documentation.