Content a11y: Vague and unclear labels for links and buttons. Device-neutral language on drop-down fields.

angelina-smith commented 5 months ago

User / Persona

As an assistive technology user, link and button text needs to be descriptive and clear so that I understand what will happen when I interact with the element. As an AT user, the phrase "Click to select" on drop-down fields can be construed as offensive for those not using a mouse.

Reason / Justification

So that when I pull up a list of links and/or buttons, I know exactly where I will be taken or what will happen when I select the element. Terminology for click insinuates mouse-usage and best practice is to avoid the word "Click" when possible.

Acceptance Criteria (AC)

Improvements noted from AT UT sessions:

[ ] Make “Start” button text (on main landing page) more descriptive
[ ] Make “Review selections” button text (in modal) more clear
[ ] Make “Open all +” and "Close all -" button text (on Results page) more descriptive

Improvements noted from USA.gov accessibility audit:

Other Notes

No response

fongcindy commented 5 months ago

@diegocob Hi Diego! We plan to focus on addressing some of the items raised in USAGov's a11y audit for our current sprint, this was one of the items.

Angelina has clearly described the changes that need to be made to meet the accessibility compliance, can you work on making these changes in content? These shouldn't take too long to address :)

diegocob commented 5 months ago

Made some suggestions in the upcoming CMS Content changes 05/23/24 doc

Please review and let me know.

angelina-smith commented 4 months ago

For some history and context of where this ticket came from:

Vague and unclear labels for links and buttons: came from the AT UT sessions
Device-neutral language on drop-down fields: came from USAgov's accessibility audit in early Jan

diegocob commented 2 weeks ago

I believe this was addressed already and we could close it, @angelina-smith.

GSA / px-benefit-finder