Open
Conversation
Updated the image description and removed redundant sections.
19 tasks
ExperimentsInHonesty
requested changes
Apr 13, 2026
| - Project Team Error guidance | ||
| - [X] Project Team Page Details | ||
| - [X] Project Team Issue and PR details | ||
| - [ ] Project Team Solution |
Member
There was a problem hiding this comment.
Please check this, since you are adding a solution
| - [ ] Project Team Solution | ||
| - [x] Credits/Authors | ||
|
|
||
| ## WAVE Error guidance |
Member
There was a problem hiding this comment.
Suggested change
| ## WAVE Alert guidance |
| <!-- Author Instructions: Add a detailed explanation of the specific accessibility problem, including context about when/where it occurs, what elements are involved, and why it's problematic for assistive technology users --> | ||
| [INSERT CONTENT] | ||
|
|
||
| `The issues above were caused by a skip in sequential heading level within a page's html. For example, if a page had a <h1> and <h3>, but no <h2>. This is problematic for assistive technology users because heading levels serve as a table of contents for understanding the structure of information on a web page. When a heading level is skipped, a user may assume there is missing information or that there are no further heading levels to explore when they encounter a heading level with no content. It is a major break in expected behavior and is disruptive for a user's ability to understand a page quickly` |
Member
There was a problem hiding this comment.
This paragraph should not be surrounded by a back tick. You can look at https://github.com/hackforla/accessibility/blob/main/docs/known-issues-and-solutions/solutions-index/error-broken-aria-reference.md for reference on formatting
| <!-- Author Instructions: Add a few sentences describing the fix. "Why the Fix Works" comes later (see below). If there are lots of instructions required to explain the solution, include them in Developer Resources below --> | ||
| [INSERT CONTENT] | ||
|
|
||
| `This can be resolved by updated the heading levels so that no levels are skipped. In the example provided above, the <h3> heading should be updated to <h2>. In addition, we should double check that this update does not create a new skipped heading level for the rest of the page and if so, update accordingly.` |
Member
There was a problem hiding this comment.
This paragraph should not be surrounded by a back tick. You can look at https://github.com/hackforla/accessibility/blob/main/docs/known-issues-and-solutions/solutions-index/error-broken-aria-reference.md for reference on formatting
| - @experimentsinhonesty | ||
| - @Rabia2219 | ||
| - @ColinBuyck | ||
| - [INCLUDE Contributor N] |
Member
There was a problem hiding this comment.
remove the extra line
- [INCLUDE Contributor N]
Rabia2219
reviewed
Apr 14, 2026
docs/known-issues-and-solutions/solutions-index/alert-skipped-heading-level.md
Show resolved
Hide resolved
Rabia2219
reviewed
Apr 14, 2026
docs/known-issues-and-solutions/solutions-index/alert-skipped-heading-level.md
Show resolved
Hide resolved
Rabia2219
reviewed
Apr 14, 2026
| #### Why the Fix Works | ||
| <!-- Author Instruction: Add an explanation of how the code changes resolve the accessibility issue and why this approach was chosen --> | ||
| [INSERT CONTENT] | ||
| - This fix becuase it removes the gap in sequential heading levels within a single page. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Creating PR since I'm the first developer updating new a11y docs.