department-of-veterans-affairs / va.gov-cms

Editor-centered management for Veteran-centered content.
https://prod.cms.va.gov
GNU General Public License v2.0
98 stars 70 forks source link

Forms download modal: [Link and button labels] Button and link language isn't descriptive and/or their purpose isn't clear. (08.03.1) #10413

Open shiragoodman opened 2 years ago

shiragoodman commented 2 years ago

General Information

VFS team name

Decision Tools

VFS product name

Find a VA Form PDF Download Instructions

Point of Contact/Reviewers

Angela Fowler (@AngelaFowler82) - Accessibility


Platform Issue

Button and link language isn't descriptive and/or their purpose isn't clear.

Issue Details

While the download links state the form number and indicate their purpose, they don't indicate the name of the form. This could be confusing for those of us who are words not numbers people.

Link, screenshot or steps to recreate

VA.gov Experience Standard

Category Number 08, Issue Number 03

Other References


Platform Recommendation

If time and resources exist, we recommend to use the heading (which contains the form name) to describe the action link and download link by utilizing aria-describedby. This will help screen reader users with cognitive disabilities to confidently make selections.

VFS Team Tasks to Complete

MarciMcGuireGCIO commented 2 years ago

This issue has been raised in previous enhancement reviews. The root of the problem is that the VA controls the data that contains the form names, some of which have names like the ones listed below. Given their length, they don't lend themselves to being displayed in a link or button easily. I will mark this blocked as it cannot be addressed until the VA makes a decision to shorten the names of these forms.

jilladams commented 1 year ago

PW now owns Find a Form. This issue is leftover from a Staging collab cycle review when Form detail pages launched, and addresses the calls to action within the mystery once-a-day modal.

Related tickets I've come across about backstory on this modal UI: https://github.com/department-of-veterans-affairs/va.gov-team/issues/33347 https://github.com/department-of-veterans-affairs/va.gov-team/issues/30377 https://github.com/department-of-veterans-affairs/va.gov-team/issues/29706 https://github.com/department-of-veterans-affairs/va.gov-team/issues/30416 (analytics) https://github.com/department-of-veterans-affairs/vets-website/pull/19368

(FYI @wesrowe )