hackforla / hackforla/tdm-calculator
Epic: WAVE Alert: Skipped heading level
- Dominant language
- JavaScript
- Stars
- 68
- Forks
- 47
- Avg merge
- 3d 9h
- Merged PRs (30d)
- 25
Description
### Depdendency
- #2960
### Overview
We want to identify all remaining development work for Skipped heading level so that we can create the issues to fix
### Details
Category: Alerts
Name: Skipped Heading Level
(The Accessibility wiki for this Alert has no solution yet)
known pages (there might be others):
1. About
This epic will do the following
- create a new issue to fix the problem on one page and update the wiki page with the solution, once accepted.
### Action Items
- [x] Go to the Solutions Index (resource 1.02) and add the link to the specific page for this problem 1.02.01
- [x] Copy the first issue template (resource 1.04)
- [x] Use the template content to create a new issue for the `About` page
- [x] Add the following labels
- role: front-end
- size: 0.25 pt
- p-feature: About
- feature: Accessibility
- level: easy
- deck: add to staging
- priority: MUST HAVE
- [x] add milestone: launch
- Customize the draft issue resoures
- [x] In this issue use the content in resource 1.03.01 (Product Documentation) to update the draft's issue resource 1.02.01, 1.02.02
- [x] In this issue use the content in resource 1.01.01 to update the link to the spreadsheet in draft issue's resource 1.03
- [x] open the spreadsheet link and find the row number, and add it to the draft issues's resource 1.03.01
- [x] In this issue, add issue to Sub Issue section below
- [ ] Once the sub issue is closed, run WAVE and check all other pages for this alert; ignore all other alerts. ~Check user interactions on the page to ensure that the alert isn't hidden by an interaction~ (there are no headings revealed by interactions on our site). Check one of the following below:
- [ ] No additional instances of this alert found
- [ ] New instances of these alerts found
- [ ] Make additional issues
### Resources
- 1.01 [TDM WAVE Accessibility Audit Spreadsheet, tab: 2. Audit Log](https://docs.google.com/spreadsheets/d/1qiAqR9LH-Gd4LO3aOs0yUy174o5LOmnuU6Bz671mKsY/edit?gid=0#gid=0)
- 1.01.01 [TDM WAVE Accessibility Audit Spreadsheet, tab: 2. Audit Log, filter: Alert: Skipped Heading Level](https://docs.google.com/spreadsheets/d/1qiAqR9LH-Gd4LO3aOs0yUy174o5LOmnuU6Bz671mKsY/edit?gid=0#gid=0&fvid=1580800818)
- 1.02 [WCAG: Known Issues and Solutions](https://hackforla.github.io/accessibility/known-issues-and-solutions)
- 1.02.01 https://hackforla.github.io/accessibility/known-issues-and-solutions/solutions-index/alert-skipped-heading-level/
- 1.03 WIKI: Product Documentation: https://github.com/hackforla/tdm-calculator/wiki/Product-Documentation
- 1.03.01 WIKI: Product Documentation, About page: https://github.com/hackforla/tdm-calculator/wiki/About
#### 1.04 first issue Template
Title
```
Dev: fix Skipped heading level on About page
```
Body
```
### Overview
We need to fix the Alert: Skipped Heading Level on [REPLACE WITH PAGE NAME] so that page can be WCAG compliant.
#### Details
Category: Alerts
Name: Skipped Heading Level
(The Accessibility wiki for this Alert has no solution yet)
Page that will be worked on:
About
### Action Items
- [ ] Review wiki page: Accessibility, How to run the WAVE browser extension (Resource 1.01)
- [ ] Install the WAVE browser extension
- [ ] Log in as the user indicated (resource 1.02.01)
- [ ] navigate to the page you are going to fix (resource 1.02.02)
- [ ] Open the TDM WAVE Accessibility Audit Spreadsheet, for this Alert (resource 1.03) and find the row that relates to this issues page.
- [ ] Run the WAVE extension with no elements focused, or clicked (resource 1.04)
- [ ] Find the Alert win WAVE shown in the Spreadsheet (1.03)
- [ ] This alert has been resolved on other pages, so look at the other issues where this was solved (resource 1.05.01 see Project Team Alert guidance section)
- [ ] Apply solution
- [ ] write and add the appropriate details to the `Project Team Solution` section (resource 1.05.01.01)
- [ ] Submit PR (include link to `Project Team Solution` section (resource 1.05.01.01)
- [ ] Add PR to spreadsheet in PR column next to Alert (resource 1.03)
- [ ] On this issue
- [ ] Add labels:
- `ready for accessibility lead`
- `ready for product`
- [ ] Change status to: `Technical Review`
- [ ] Get sign-off on WIKI page by
- [ ] Accessibility lead
- [ ] Product lead
- [ ] release the dependency on [INSERT LINK TO NEXT ISSUE]
### Resources/Instructions
- 1.01[How to run the WAVE browser extension](https://hackforla.github.io/accessibility/getting-started/wave-browser-extension/)
- 1.02 Application details
- 1.02.01 User Profile Required: [REPLACE WITH USER TYPE: visitor (not logged in)/user/admin/security admin/]
- 1.02.02 Page URL: http://tdm-dev.azurewebsites.net/[REPLACE WITH PAGE URL]
- Requires sign in: [REPLACE WITH TRUE OR FALSE]
- Can access page directly from URL: [REPLACE WITH TRUE OR FALSE]
- 1.03 [TDM WAVE Accessibility Audit Spreadsheet, tab: 2. Audit Log, filter: Alert: [REPLACE WITH FILTER NAME]]
- Spreadsheet Row(s): [REPLACE WITH ROW NUMBERS]
- 1.04 https://hackforla.github.io/accessibility/getting-started/perform-wave-audit
- 1.05 [Accessibility Known Issues Index](https://hackforla.github.io/accessibility/known-issues-and-solutions/solutions-index/)
- 1.05.01 [WAVE Known Accessibility Issue: Alert - Skipped heading level](https://hackforla.github.io/accessibility/known-issues-and-solutions/solutions-index/alert-skipped-heading-level/)
- 1.05.01.01 [WAVE Known Accessibility Issue: Alert - Skipped heading level, project-team-solution](https://hackforla.github.io/accessibility/known-issues-and-solutions/solutions-index/alert-skipped-heading-level/#project-team-solution)
Additional reading (optional)
- TDM [Accessibility Audits](https://hackforla.github.io/accessibility/)
#### Slides
- [Staging Deck](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg)
- [Staging Deck, slide ]
- Release deck
- [2026-01-20 Release deck, slide ]
```
#### Slides
- [Staging Deck](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg)
- [Staging Deck, slide 2897] - N/A
- Release deck
- [2026-01-20 Release deck, slide 2897] - N/A
Contributor guide
Research direction
Start with dependency #2960, the About page in the Product Documentation wiki, and the WAVE browser-extension instructions. Run the WAVE audit for the skipped-heading-level alert, review the linked known-issues resources, and follow the project’s review process. Done means the About alert is resolved, the solution is documented, and remaining pages have been checked.
Written by the indexing model from the issue text.
Assessment
- Domain
- accessibility, frontend
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100