From 6014aa771b9e7c1bcec0cf9fd4a672a2d3437770 Mon Sep 17 00:00:00 2001 From: Rabia Shaikh Date: Thu, 26 Feb 2026 11:20:43 -0600 Subject: [PATCH 01/16] Update alert-link-to-pdf-document.md fix WAVE Info Dropdown --- .../alert-link-to-pdf-document.md | 37 +++++++++---------- 1 file changed, 18 insertions(+), 19 deletions(-) diff --git a/docs/known-issues-and-solutions/solutions-index/alert-link-to-pdf-document.md b/docs/known-issues-and-solutions/solutions-index/alert-link-to-pdf-document.md index 2b1e12c4..0e1b3451 100644 --- a/docs/known-issues-and-solutions/solutions-index/alert-link-to-pdf-document.md +++ b/docs/known-issues-and-solutions/solutions-index/alert-link-to-pdf-document.md @@ -15,25 +15,24 @@ WAVE Tool's Reference material on Link to PDF document may not specifically address your problem. We provide it here for optional reading. -
Click to see WAVE Tool Reference - - - -### WAVE Category -Alerts -### WAVE Error -Link to PDF document -### What It Means -A link to a PDF document is present. -### Why It Matters -Unless authored with accessibility in mind, PDF documents often have accessibility issues. Additionally, PDF documents are typically viewed using a separate application or plug-in, and can thus cause confusion and navigation difficulties. -### What To Do -Ensure the PDF document is natively accessible. Additionally, inform the user that the link will open a PDF document. Because PDF documents may have limitations in accessibility (particularly for complex content) and require a separate program, HTML content should often be used in place of or in addition to the PDF document. -### The Algorithm... in English -A link to a .pdf file is present. -### Standards and Guidelines -None -
+??? Info "Click to see WAVE Tool Reference" + + + + > ### WAVE Category + > Alerts + > ### WAVE Error + > Link to PDF document + > ### What It Means + > A link to a PDF document is present. + > ### Why It Matters + > Unless authored with accessibility in mind, PDF documents often have accessibility > issues. Additionally, PDF documents are typically viewed using a separate application or plug- in, and can thus cause confusion and navigation difficulties. + > ### What To Do + > Ensure the PDF document is natively accessible. Additionally, inform the user that the link will open a PDF document. Because PDF documents may have limitations in accessibility (particularly for complex content) and require a separate program, HTML content should often be used in place of or in addition to the PDF document. + > ### The Algorithm... in English + > A link to a .pdf file is present. + > ### Standards and Guidelines + > None ## Example of a DOM Snippet Generated From WAVE Tool From e76118e540db003de8120a2a7b423d330eea5f28 Mon Sep 17 00:00:00 2001 From: Rabia Shaikh Date: Thu, 26 Feb 2026 11:23:13 -0600 Subject: [PATCH 02/16] Update alert-missing-fieldset.md --- .../solutions-index/alert-missing-fieldset.md | 46 +++++++++---------- 1 file changed, 21 insertions(+), 25 deletions(-) diff --git a/docs/known-issues-and-solutions/solutions-index/alert-missing-fieldset.md b/docs/known-issues-and-solutions/solutions-index/alert-missing-fieldset.md index ed42ad3d..4544562f 100644 --- a/docs/known-issues-and-solutions/solutions-index/alert-missing-fieldset.md +++ b/docs/known-issues-and-solutions/solutions-index/alert-missing-fieldset.md @@ -15,31 +15,27 @@ WAVE Tool's Reference material on Missing fieldset may not specifically address your problem. We provide it here for optional reading. -
Click to see WAVE Tool Reference -

- - - -> ### WAVE Category -> Alerts -> ### WAVE Error -> Missing fieldset -> ### What It Means -> A group of check boxes or radio buttons is not enclosed in a fieldset. -> ### Why It Matters -> A fieldset provides a visual and structural grouping of related form elements. It is typically necessary for groups of check boxes or radio buttons where a higher level description (called a legend) is necessary to understand the function of the check boxes or radio buttons. The description will be identified by a screen reader only if provided in a fieldset legend. -> ### What To Do -> Determine whether the grouping of check boxes or radio buttons has or needs text that explains the purpose of the check boxes or radio button grouping. If so, mark up the group within a fieldset and put the group description in a legend element. -> ### The Algorithm... in English -> Two or more checkbox or radio input elements within a form have the same name value, but are not enclosed in a fieldset. -> ### Standards and Guidelines -> - [1.1.1 Non-text Content (Level A)](https://webaim.org/standards/wcag/checklist#sc1.1.1) -> - [1.3.1 Info and Relationships (Level A)](https://webaim.org/standards/wcag/checklist#sc1.3.1) -> - [2.4.6 Headings and Labels (Level AA)](https://webaim.org/standards/wcag/checklist#sc2.4.6) -> - [3.3.2 Labels or Instructions (Level A)](https://webaim.org/standards/wcag/checklist#sc3.3.2) - -

-
+??? Info "Click to see WAVE Tool Reference" + + + + > ### WAVE Category + > Alerts + > ### WAVE Error + > Missing fieldset + > ### What It Means + > A group of check boxes or radio buttons is not enclosed in a fieldset. + > ### Why It Matters + > A fieldset provides a visual and structural grouping of related form elements. It is typically necessary for groups of check boxes or radio buttons where a higher level description (called a legend) is necessary to understand the function of the check boxes or radio buttons. The description will be identified by a screen reader only if provided in a fieldset legend. + > ### What To Do + > Determine whether the grouping of check boxes or radio buttons has or needs text that explains the purpose of the check boxes or radio button grouping. If so, mark up the group within a fieldset and put the group description in a legend element. + > ### The Algorithm... in English + > Two or more checkbox or radio input elements within a form have the same name value, but are not enclosed in a fieldset. + > ### Standards and Guidelines + > - [1.1.1 Non-text Content (Level A)](https://webaim.org/standards/wcag/checklist#sc1.1.1) + > - [1.3.1 Info and Relationships (Level A)](https://webaim.org/standards/wcag/checklist#sc1.3.1) + > - [2.4.6 Headings and Labels (Level AA)](https://webaim.org/standards/wcag/checklist#sc2.4.6) + > - [3.3.2 Labels or Instructions (Level A)](https://webaim.org/standards/wcag/checklist#sc3.3.2) ## Example of a DOM Snippet Generated From WAVE Tool From 92456dad7338e91f70dfb857c009ba9a9bf2c35a Mon Sep 17 00:00:00 2001 From: Rabia Shaikh Date: Thu, 26 Feb 2026 11:34:54 -0600 Subject: [PATCH 03/16] Update alert-orphaned-form-label.md --- .../alert-orphaned-form-label.md | 53 +++++++++---------- 1 file changed, 25 insertions(+), 28 deletions(-) diff --git a/docs/known-issues-and-solutions/solutions-index/alert-orphaned-form-label.md b/docs/known-issues-and-solutions/solutions-index/alert-orphaned-form-label.md index 637e6139..a98071de 100644 --- a/docs/known-issues-and-solutions/solutions-index/alert-orphaned-form-label.md +++ b/docs/known-issues-and-solutions/solutions-index/alert-orphaned-form-label.md @@ -15,34 +15,31 @@ WAVE Tool's Reference material on Orphaned form label may not specifically address your problem. We provide it here for optional reading. -
Click to see WAVE Tool Reference -

- - - -### WAVE Category -Alert - -### WAVE Error -Orphaned form label - -### What It Means -A form label is present, but it is not correctly associated with a form control. - -### Why It Matters -If a label is not associated with a control, screen reader users may not know the function or purpose of the form control. - -### What To Do -If the label is for a form control that is present on the page, ensure that the for attribute of the label references the id value of the associated form control. If no form control is present, either remove the label or add the missing control. - -### The Algorithm... in English -[REPLACE WITH WAVE CONTENT FOR The Algorithm... In English] - -### Standards and Guidelines -A `

-
+??? Info "Click to see WAVE Tool Reference" + + + + > ### WAVE Category + > Alert + > ### WAVE Error + > Orphaned form label + > ### What It Means + > A form label is present, but it is not correctly associated with a form control. + > ### Why It Matters + > An incorrectly associated label does not provide functionality or information about the form control to the user. It usually indicates a coding or other form labeling issues. + > ### What To Do + > Properly associate the label with its corresponding form control. If there is no corresponding form control, remove the label. Labels are not appropriate for image, submit, reset, button, or hidden form controls. + > ### The Algorithm... in English + > A `