Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

DST Staging Review: Screenshots must have descriptive alternative text. #3383

Open
shiragoodman opened this issue Oct 15, 2024 · 1 comment

Comments

@shiragoodman
Copy link
Collaborator

Need help? Please review how to read a Staging Review ticket. Tag @platform-governance-team-members on Slack if you need further assistance.

Design System Staging Information

Component: Help users to... Know when their information is prefilled
Staging Review ticket: AEDP, Design Patterns, Help users to... Know when their information is prefilled

Findings details

VA.gov Experience Standard - issue: User can't perceive an element.
VA.gov Experience Standard - category: Comprehension
This is an issue with the:
High-priority: yes
Collab Cycle Reviewer: @briandeconinck (Accessibility)

Description

You must provide alternative text that describes the content of an image, so that VFS team members who can't perceive an image visually will still be able to understand the information in the image. Currently, alt text is empty, just a restatement of the image caption, or not descriptive of the content displayed.

Recommended action

Good alt text for a screenshot is a bit of an art. It's different than what's in the image caption, and more of a literal description of what's in the image itself. But you don't need to describe everything in the image, just the parts that are contextually relevant.

For example, for the personal information page screenshot, I might write alt text like:

Veteran information page in a form flow with an uneditable card containing the Veteran's name, privacy masked Social Security number, date of birth, and gender. After the card is a note explaining why the content can't be edited and how to update this information.

Each screenshot must have text that's comparably descriptive included in the alt attribute of the img element.

References


Next Steps for DST

  • Close the ticket when the issue has been resolved or validated by your Product Owner
  • If your team has additional questions or needs Governance help validating the issue, please comment on the ticket
  • If this ticket has a high-priority label, please address as soon as possible so VFS teams are not impacted
  • If this ticket has a consider label, please consider for future implementation
@msbtterswrth
Copy link

@ChristineRoseSteiffer could you look through the alt text for images and update them? If you need help writing the content lmk and I can help you out.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants