kb-help-url-reference

## Help URL Reference Centralized mapping of accessibility rule IDs and WCAG criteria to external help documentation. Used by CSV reporters, audit report generators, and any agent that links findings to remediation guidance. ## Accessibility Insights (Web Accessibility) ### axe-core Rule URL Pattern ```text Base URL: https://accessibilityinsights.io/info-examples/web/ Pattern: {base_url}{rule-id} Example: https://accessibilityinsights.io/info-examples/web/image-alt/ ``` For any axe-core rule, construct the URL by appending the rule ID to the base URL. This pattern covers all axe-core rules. ### Common axe-core Rules Each rule ID, with its issue, WCAG and help URL. | Rule ID | Issue | WCAG | Help URL | |---------|-------|------|---------------| | `image-alt` | Image missing alternative text | 1.1.1 | `https://accessibilityinsights.io/info-examples/web/image-alt/` | | `button-name` | Button has no accessible name | 4.1.2 | `https://accessibilityinsights.io/info-examples/web/button-name/` | | `color-contrast` | Text has insufficient contrast | 1.4.3 | `https://accessibilityinsights.io/info-examples/web/color-contrast/` | | `label` | Form element has no label | 1.3.1 | `https://accessibilityinsights.io/info-examples/web/label/` | | `link-name` | Link has no discernible text | 4.1.2 | `https://accessibilityinsights.io/info-examples/web/link-name/` | | `html-has-lang` | Page missing lang attribute | 3.1.1 | `https://accessibilityinsights.io/info-examples/web/html-has-lang/` | | `document-title` | Page missing title | 2.4.2 | `https://accessibilityinsights.io/info-examples/web/document-title/` | | `heading-order` | Heading levels skipped | 1.3.1 | `https://www.w3.org/WAI/WCAG22/Understanding/info-and-relationships.html` | | `aria-roles` | Invalid ARIA role | 4.1.2 | `https://accessibilityinsights.io/info-examples/web/aria-roles/` | | `aria-required-attr` | Missing required ARIA attribute | 4.1.2 | `https://accessibilityinsights.io/info-examples/web/aria-required-attr/` | | `aria-valid-attr` | Invalid ARIA attribute | 4.1.2 | `https://accessibilityinsights.io/info-examples/web/aria-valid-attr/` | | `bypass` | No skip navigation link | 2.4.1 | `https://accessibilityinsights.io/info-examples/web/bypass/` | | `region` | Content not in landmark | 1.3.1 | `https://www.w3.org/WAI/WCAG22/Understanding/info-and-relationships.html` | | `tabindex` | Positive tabindex used | 2.4.3 | `https://www.w3.org/WAI/WCAG22/Understanding/focus-order.html` | | `duplicate-id` | Duplicate element ID | 4.1.1 | `https://accessibilityinsights.io/info-examples/web/duplicate-id/` | | `focus-order-semantics` | Focus order issue | 2.4.3 | `https://www.w3.org/WAI/WCAG22/Understanding/focus-order.html` | | `input-image-alt` | Input image missing alt | 1.1.1 | `https://accessibilityinsights.io/info-examples/web/input-image-alt/` | | `meta-viewport` | Viewport disables zoom | 1.4.4 | `https://accessibilityinsights.io/info-examples/web/meta-viewport/` | | `select-name` | Select element has no label | 4.1.2 | `https://accessibilityinsights.io/info-examples/web/select-name/` | | `autocomplete-valid` | Invalid autocomplete value | 1.3.5 | `https://accessibilityinsights.io/info-examples/web/autocomplete-valid/` | ### W3C/WAI Topic Pages (Non-axe Issues) For agent-detected issues without axe-core rule IDs, use these W3C/WAI pages: | Topic | URL | |-------|-----| | Focus management | `https://www.w3.org/WAI/WCAG22/Understanding/focus-order.html` | | Live regions | `https://www.w3.org/WAI/WCAG22/Understanding/status-messages.html` | | Modal dialogs | `https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/` | | Data tables | `https://www.w3.org/WAI/tutorials/tables/` | ## Microsoft Office (Document Accessibility) ### Word (DOCX) Rules > Rule IDs match the canonical definitions in the `word-accessibility` format agent. | Rule ID | Issue | Help URL | |---------|-------|----------| | `DOCX-E001` | Missing alt text on images | `https://support.microsoft.com/en-us/office/add-alternative-text-to-a-shape-picture-chart-smartart-graphic-or-other-object-44989b2a-903c-4d9a-b742-6a75b451c669` | | `DOCX-E002` | Missing table header row | `https://support.microsoft.com/en-us/office/create-accessible-tables-in-word-cb464015-59dc-46a0-ac01-6217c62210e5` | | `DOCX-E003` | Skipped heading levels | `https://support.microsoft.com/en-us/office/create-accessible-word-documents-d9bf3683-87ac-47ea-b91a-78dcacb3c66d#bkmk_headings` | | `DOCX-E004` | Missing document title | `https://support.microsoft.com/en-us/office/create-accessible-word-documents-d9bf3683-87ac-47ea-b91a-78dcacb3c66d#bkmk_doctitle` | | `DOCX-E005` | Merged or split table cells | `https://support.microsoft.com/en-us/office/create-accessible-tables-in-word-cb464015-59dc-46a0-ac01-6217c62210e5` | | `DOCX-E006` | Ambiguous hyperlink text | `https://support.microsoft.com/en-us/office/create-accessible-word-documents-d9bf3683-87ac-47ea-b91a-78dcacb3c66d#bkmk_links` | | `DOCX-E007` | No heading structure | `https://support.microsoft.com/en-us/office/create-accessible-word-documents-d9bf3683-87ac-47ea-b91a-78dcacb3c66d#bkmk_headings` | | `DOCX-E008` | Document access restricted (IRM) | `https://support.microsoft.com/en-us/office/create-accessible-word-documents-d9bf3683-87ac-47ea-b91a-78dcacb3c66d` | | `DOCX-E009` | Content controls without titles | `https://support.microsoft.com/en-us/office/create-accessible-word-documents-d9bf3683-87ac-47ea-b91a-78dcacb3c66d` | | `DOCX-W001` | Nested tables | `https://support.microsoft.com/en-us/office/create-accessible-tables-in-word-cb464015-59dc-46a0-ac01-6217c62210e5` | | `DOCX-W002` | Long alt text (>150 chars) | `https://support.microsoft.com/en-us/office/everything-you-need-to-know-to-write-effective-alt-text-df98f884-ca3d-456c-807b-1a1fa82f5dc2` | | `DOCX-W003` | Manual list characters | `https://support.microsoft.com/en-us/office/create-accessible-word-documents-d9bf3683-87ac-47ea-b91a-78dcacb3c66d` | | `DOCX-W004` | Blank table rows for spacing | `https://support.microsoft.com/en-us/office/create-accessible-tables-in-word-cb464015-59dc-46a0-ac01-6217c62210e5` | | `DOCX-W005` | Heading exceeds 100 characters | `https://support.microsoft.com/en-us/office/create-accessible-word-documents-d9bf3683-87ac-47ea-b91a-78dcacb3c66d#bkmk_headings` | | `DOCX-W006` | Watermark present | `https://support.microsoft.com/en-us/office/create-accessible-word-documents-d9bf3683-87ac-47ea-b91a-78dcacb3c66d#bkmk_watermarks` | | `DOCX-T001` | Missing document language | `https://support.microsoft.com/en-us/office/create-accessible-word-documents-d9bf3683-87ac-47ea-b91a-78dcacb3c66d#bkmk_language` | | `DOCX-T002` | Layout table with header markup | `https://support.microsoft.com/en-us/office/create-accessible-tables-in-word-cb464015-59dc-46a0-ac01-6217c62210e5` | | `DOCX-T003` | Repeated blank characters | `https://support.microsoft.com/en-us/office/create-accessible-word-documents-d9bf3683-87ac-47ea-b91a-78dcacb3c66d#bkmk_whitespace` | ### Excel (XLSX) Rules > Rule IDs match the canonical definitions in the `excel-accessibility` format agent. | Rule ID | Issue | Help URL | |---------|-------|----------| | `XLSX-E001` | Missing alt text on images/charts | `https://support.microsoft.com/en-us/office/add-alternative-text-to-a-shape-picture-chart-smartart-graphic-or-other-object-44989b2a-903c-4d9a-b742-6a75b451c669` | | `XLSX-E002` | Missing table header row | `https://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593#bkmk_tableheaders` | | `XLSX-E003` | Default sheet names | `https://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593#bkmk_sheettabs` | | `XLSX-E004` | Merged cells in data tables | `https://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593#bkmk_mergedcells` | | `XLSX-E005` | Ambiguous hyperlink text | `https://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593` | | `XLSX-E006` | Missing workbook title | `https://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593#bkmk_doctitle` | | `XLSX-E007` | Red-only negative number formatting | `https://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593#bkmk_color` | | `XLSX-E008` | Workbook access restricted (IRM) | `https://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593` | | `XLSX-W001` | Blank cells used for formatting | `https://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593` | | `XLSX-W002` | Color-only data differentiation | `https://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593#bkmk_color` | | `XLSX-W003` | Complex table structure | `https://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593#bkmk_mergedcells` | | `XLSX-W004` | Empty worksheet | `https://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593` | | `XLSX-W005` | Long alt text (>150 chars) | `https://support.microsoft.com/en-us/office/everything-you-need-to-know-to-write-effective-alt-text-df98f884-ca3d-456c-807b-1a1fa82f5dc2` | | `XLSX-T001` | Sheet tab order not logical | `https://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593#bkmk_sheettabs` | | `XLSX-T002` | Missing named ranges | `https://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593` | | `XLSX-T003` | Missing workbook language | `https://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593` | ### PowerPoint (PPTX) Rules > Rule IDs match the canonical definitions in the `powerpoint-accessibility` format agent. | Rule ID | Issue | Help URL | |---------|-------|----------| | `PPTX-E001` | Missing alt text on images | `https://support.microsoft.com/en-us/office/add-alternative-text-to-a-shape-picture-chart-smartart-graphic-or-other-object-44989b2a-903c-4d9a-b742-6a75b451c669` | | `PPTX-E002` | Missing slide titles | `https://support.microsoft.com/en-us/office/create-accessible-powerpoint-presentations-6f7772b2-2f33-4bd2-8ca7-dae3b2b3ef25#bkmk_slidetitles` | | `PPTX-E003` | Duplicate slide titles | `https://support.microsoft.com/en-us/office/create-accessible-powerpoint-presentations-6f7772b2-2f33-4bd2-8ca7-dae3b2b3ef25#bkmk_slidetitles` | | `PPTX-E004` | Missing table header row | `https://support.microsoft.com/en-us/office/create-accessible-powerpoint-presentations-6f7772b2-2f33-4bd2-8ca7-dae3b2b3ef25#bkmk_tableheaders` |