Issue Template: Epic 4 Sub-Template — Create, Apply & Document Solution (1 Page)

What does this template do?

Creates a child fix-epic inside Epic 4. The scope of work is to research and develop a new solution for one specific WAVE error or alert, apply it to the single affected page, and document the solution in the Known Issues Index for future reuse. After the fix is merged, the developer checks for any other affected pages across the site.

When should this template be used?

Use this template inside Epic 4 when:

There is no solution in the Known Issues and Solutions Index, and
Only 1 page is currently known to be affected.

If this is not the correct template, see the Wiki and Issue Templates page for all available templates.

Labels

feature: Accessibility

p-feature: [REPLACE WITH PAGE NAME]

Title

Epic: WAVE: [REPLACE WITH ONE OF: Alert / Contrast Error / Error]: [REPLACE WITH NAME OF Alert/Contrast Error/Error]

Body

<!-- Customize this epic issue by replacing all content in [ ] -->

### Overview

We need to research, create, and document a solution for
[REPLACE WITH ONE OF: Alert / Contrast Error / Error]:
[REPLACE WITH NAME OF Alert/Contrast Error/Error] and apply it to the
affected page so the site can be WCAG compliant and so the solution is
available for future teams.

### Details
Category: [REPLACE WITH ONE OF: Alert / Contrast Error / Error]
Name: [REPLACE WITH NAME OF Alert/Contrast Error/Error]
(The Known Issues Index has no solution yet for this issue)

Known page (there might be others):
1. [REPLACE WITH PAGE NAME]

This epic will:
- Create a child issue to research, apply, and document a fix on the one
  known page
- After the fix is merged, verify whether the issue exists on any other pages

### Action Items
- [ ] Go to the Known Issues Solutions Index (resource 1.02) and add the link
      to the specific solutions page for this issue as resource 1.02.01
- [ ] Copy the child issue template (resource 1.04) and create a new issue
      for the `[REPLACE WITH PAGE NAME]` page
   - [ ] Add the following labels to the new child issue:
      - `role: front-end`
      - `size: missing`
      - `p-feature: [REPLACE WITH PAGE NAME]`
      - `feature: Accessibility`
      - `level: missing`
      - `ready for dev lead`
      - `priority: MUST HAVE`
   - [ ] Add milestone: [REPLACE WITH MILESTONE NAME, if applicable]
   - Customize the child issue resources:
      - [ ] Update the child issue's resource 1.02.01 and 1.02.02 using
            the application details for this page
      - [ ] Find the spreadsheet row for this page and error, and update
            the child issue's resource 1.03 with the correct link and
            row number(s)
- [ ] Add the new issue as a sub-issue of this epic
- [ ] Once the child issue is merged and closed, run WAVE on all other pages
      for this [REPLACE WITH ONE OF: Alert / Contrast Error / Error]:
      [REPLACE WITH NAME OF Alert/Contrast Error/Error] only — ignore all
      other errors and alerts. Check user interaction states as well.
   - [ ] No additional instances found — close this epic
   - [ ] Additional instances found — create a new epic using the
         [Epic: Apply code solution for 1 or more pages](https://hackforla.github.io/accessibility/wiki-and-issue-templates/issue-template-epic-apply-solution/)
         template and link it here

### Sub-Issues

<!-- Add child fix issue once created -->

### Resources
- 1.01 WAVE Accessibility Audit Spreadsheet, tab: Audit Log:
       [REPLACE WITH LINK TO AUDIT SPREADSHEET]
   - 1.01.01 Audit Spreadsheet, filter:
             [REPLACE WITH FILTER NAME FOR THIS ALERT/ERROR]
- 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/[REPLACE WITH SLUG-WITH-DASHES]/
- 1.03 Project documentation / page inventory:
       [REPLACE WITH LINK TO YOUR PROJECT'S PAGE DOCS OR WIKI]
   - 1.03.01 Documentation for [REPLACE WITH PAGE NAME] page:
             [REPLACE WITH LINK OR LEAVE BLANK]

#### 1.04 Child Issue Template

Title

Dev: fix [REPLACE WITH Alert/Contrast Error/Error] on [REPLACE WITH PAGE NAME] page

Body

Overview

We need to fix the [REPLACE WITH ONE OF: Alert / Contrast Error / Error]: [REPLACE WITH NAME OF Alert/Contrast Error/Error] on [REPLACE WITH PAGE NAME] so that the page is WCAG compliant, and to document the solution in the Known Issues Index for future reuse.

Details

Category: [REPLACE WITH ONE OF: Alert / Contrast Error / Error] Name: [REPLACE WITH NAME OF Alert/Contrast Error/Error] (No solution exists in the Known Issues Index yet — this issue will create one)

Page to fix: [REPLACE WITH PAGE NAME]

Action Items

Resources

1.01 How to run the WAVE browser extension
1.02 Application details
1.02.01 User Profile Required: [REPLACE WITH USER TYPE: visitor / user / admin / etc.]
1.02.02 Page URL: [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 WAVE Accessibility Audit Spreadsheet, tab: Audit Log, filter: [REPLACE WITH FILTER NAME]: [REPLACE WITH LINK TO SPREADSHEET]
Spreadsheet Row(s): [REPLACE WITH ROW NUMBERS]
1.04 Perform a WAVE audit
1.05 WCAG Known Issues and Solutions Index
1.05.01 WAVE Known Accessibility Issue: [REPLACE WITH ONE OF: Alert / Contrast Error / Error] — [REPLACE WITH NAME OF Alert/Contrast Error/Error]: [REPLACE WITH WIKI PAGE LINK]
- 1.05.01.01 Project Team Solution section: [REPLACE WITH DIRECT ANCHOR LINK TO SOLUTION SECTION]