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

Public resources for building on and in support of VA.gov. Visit complete Knowledge Hub:
https://depo-platform-documentation.scrollhelp.site/index.html
282 stars 203 forks source link

[Content organization] Your page doesn't follow heading hierarchy. Headings aren't properly nested, and headings and/or labels aren't relevant to the page. (02.04.1) #46639

Open shiragoodman opened 2 years ago

shiragoodman commented 2 years ago

General Information

VFS team name

MOVE

VFS product name

1095B Tax Form

VFS feature name

1095B Tax Form - accessibility version

Point of Contact/Reviewers

Brian DeConinck (@briandeconinck) - Accessibility

*For more information on how to interpret this ticket, please refer to the Anatomy of a Staging Review issue ticket guidance on Platform Website.


Platform Issue

Your page doesn't follow heading hierarchy. Headings aren't properly nested, and headings and/or labels aren't relevant to the page.

Issue Details

The heading "Choose your file format and download your document" is coded as an H3, and each of the alerts (successful download and failed download) also have H3 headings.

From the Sketch prototype, it looks like these headings are always the next heading that follows the H1 on the page. They should be H2s rather than H3s.

Link, screenshot or steps to recreate

VA.gov Experience Standard

Category Number 02, Issue Number 04

Other References

WCAG SC 1.3.1_A WCAG SC 2.4.6_AA


Platform Recommendation

Change the H3 headings to H2 headings.

VFS Team Tasks to Complete

joshkimux commented 1 year ago

Hi @mdewey ! Would love your help on this ticket as part of our larger a11y dashboard effort.

Platform recommends to fix defect-2 issues in 1-2 sprints post launch, but more importantly, this is a huge usability boost for Veterans using screen readers 🙇