Accessibility: Adding alt text to site images #233
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
On the Shoutem documentation site, many images are not tagged with alt-text or aria labels. This poses an accessibility issue, as these images are not accessible without being able to visually understand the context and importance of the image.
Background
Per the ADA, sites should be accessible to all users. Those who use screen readers or other accessibility tools may rely on alt text describing images or graphics. This alt-text requirement is codified in the WCAG 2.0 from 2008, in Section 1.1.1 which states that any image or graphic other than those which are purely decorative or formatting should have alternative text which describes all information a user might glean from it visually.
Example of Good Alt Text
Good alt text would be concisely and completely describing the contents of an image. For example,
Your Proposal for Changes
The diff in this PR shows changes to the
img
attributes in the docs adding descriptive alt text.