Skip to content

Commit 02e2af7

Browse files
ExperimentsInHonestyExperimentsInHonesty
authored
Create issue-template-epic-solution-none
1 parent de634ca commit 02e2af7

1 file changed

Lines changed: 211 additions & 0 deletions

File tree

‎docs/wiki-and-issue-templates/issue-template-epic-solution-none‎

Lines changed: 211 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,211 @@
1+
Issue Template for Epic where there is no solution yet and there are two pages where it appears
2+
3+
Title
4+
```
5+
Epic: WAVE: [[REPLACE WITH Alert/Aria/Contrast Error/Error]
6+
```
7+
Body
8+
```
9+
### Overview
10+
11+
We want to identify all remaining development work for [REPLACE WITH Alert/Aria/Contrast Error/Error] so that we can create the issues to fix
12+
13+
### Details
14+
Category: [REPLACE WITH ONE OF THESE CATEGORIES Alert/Aria/Contrast Error/Error]
15+
Name: [REPLACE WITH NAME OF Alert/Aria/Contrast Error/Error]
16+
(The Accessibility wiki for this Alert has no solution yet)
17+
18+
known pages (there might be others):
19+
1. [REPLACE WITH NAME OF PAGE NAME 1]
20+
1. [REPLACE WITH NAME OF PAGE NAME N]
21+
22+
This epic will do the following
23+
- create a new issue to fix the problem on one page and update the wiki page with the solution, once accepted.
24+
- create any follow-on issues to fix any other occurrences of this problem
25+
26+
### Action Items
27+
- [ ] Go to the Solutions Index (resource 1.02) and add the link to the specific page for this problem 1.02.01
28+
- [ ] Copy the first issue template (resource 1.04)
29+
- [ ] Use the template content to create a new issue for the `About` page
30+
- [ ] Add the following labels
31+
- role: front-end
32+
- size: missing
33+
- p-feature: [REPLACE WITH NAME OF PAGE]
34+
- feature: Accessibility
35+
- level: missing
36+
- deck: add to staging
37+
- ready for dev lead
38+
- priority: MUST HAVE
39+
- [ ] add milestone: launch
40+
- Customize the draft issue resoures
41+
- [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
42+
- [x] In this issue use the content in resource 1.01 & 1.01.01 (spreadsheet) to update draft issue's resource 1.03
43+
- [ ] In this issue, add issue to Sub Issue section below
44+
- [ ] Copy the second issue template (resource 1.05)
45+
- [ ] Use the template content to create a new issue(s) for the remaining pages under Known pages above
46+
- [ ] Customize the draft
47+
- [ ] Add the following labels
48+
- role: front-end
49+
- size: missing
50+
- p-feature: Checklist
51+
- feature: Accessibility
52+
- level: missing
53+
- deck: add to staging
54+
- ready for dev lead
55+
- priority: MUST HAVE
56+
- Customize the draft issue resoures
57+
- [ ] In this issue use the content in resource Product Documentation 1.03.01 to update the draft's issue resource 1.02.01, 1.02.02
58+
- [ ] 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
59+
- [ ] open the spreadsheet link and find the row number, and add it to the draft issues's resource 1.03.01
60+
- [ ] Once both those issues are 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. Check one of the following below:
61+
- [ ] No additional instances of this alert found
62+
- [ ] New instances of these alerts found
63+
- [ ] Make additional issues
64+
65+
66+
### Resources
67+
- 1.01 [TDM WAVE Accessibility Audit Spreadsheet, tab: 2. Audit Log](https://docs.google.com/spreadsheets/d/1qiAqR9LH-Gd4LO3aOs0yUy174o5LOmnuU6Bz671mKsY/edit?gid=0#gid=0)
68+
- 1.01.01 [TDM WAVE Accessibility Audit Spreadsheet, tab: 2. Audit Log, filter: [REPLACE WITH NAME OF FILTER FOR Alert/Aria/Contrast Error/Error]
69+
- 1.02 [WCAG: Known Issues and Solutions](https://hackforla.github.io/accessibility/known-issues-and-solutions)
70+
- 1.02.01 https://hackforla.github.io/accessibility/known-issues-and-solutions/solutions-index/[REPLACE WITH PAGE NAME WITH DASHES]/
71+
- 1.03 WIKI: Product Documentation: https://github.com/hackforla/tdm-calculator/wiki/Product-Documentation
72+
- 1.03.01 WIKI: Product Documentation, [REPLACE WITH PAGE NAME] page:
73+
74+
#### 1.04 first issue Template
75+
Title
76+
```
77+
Dev: fix [REPLACE WITH Alert/Aria/Contrast Error/Error] on [REPLACE WITH PAGE NAME] page
78+
```
79+
Body
80+
```
81+
### Overview
82+
We need to fix the Alert: [REPLACE WITH Alert/Aria/Contrast Error/Error](s) on [REPLACE WITH PAGE NAME] so that page can be WCAG compliant.
83+
84+
#### Details
85+
Category: [REPLACE WITH ONE OF THESE CATEGORIES Alert/Aria/Contrast Error/Error]
86+
Name: [REPLACE WITH NAME OF Alert/Aria/Contrast Error/Error]
87+
(The Accessibility wiki for this Alert has no solution yet)
88+
89+
Page that will be worked on:
90+
[REPLACE WITH NAME OF PAGE NAME]
91+
92+
### Action Items
93+
- [ ] Review wiki page: Accessibility, How to run the WAVE browser extension (Resource 1.01)
94+
- [ ] Install the WAVE browser extension
95+
- [ ] Log in as the user indicated (resource 1.02.01)
96+
- [ ] navigate to the page you are going to fix (resource 1.02.02)
97+
- [ ] Open the TDM WAVE Accessibility Audit Spreadsheet, for this Alert/Aria/Contrast Error/Error (resource 1.03) and find the row that relates to this issues page.
98+
- [ ] Run the WAVE extension with no elements focused, or clicked (resource 1.04)
99+
- [ ] Find the [REPLACE WITH ONE OF THESE CATEGORIES Alert/Aria/Contrast Error/Error] win WAVE shown in the Spreadsheet (1.03)
100+
- [ ] This [REPLACE WITH ONE OF THESE CATEGORIES Alert/Aria/Contrast Error/Error] has been resolved on other pages, so look at the other issues where this was solved (resource 1.05.01 see Project Team Error guidance section)
101+
- [ ] Apply solution
102+
- [ ] write and add the appropriate details to the `Project Team Solution` section (resource 1.05.01.01)
103+
- [ ] Submit PR (include link to `Project Team Solution` section (resource 1.05.01.01)
104+
- [ ] Add PR to spreadsheet in PR column next to Alert/Aria/Contrast Error/Error (resource 1.03)
105+
- [ ] On this issue
106+
- [ ] Add labels:
107+
- `ready for accessibility lead`
108+
- `ready for product`
109+
- [ ] Change status to: `Technical Review`
110+
- [ ] Get sign-off on WIKI page by
111+
- [ ] Accessibility lead
112+
- [ ] Product lead
113+
- [ ] release the dependencies on
114+
- [INSERT LINK TO NEXT ISSUE(s)]
115+
- [INSERT LINK TO EPIC]
116+
117+
### Resources/Instructions
118+
- 1.01[How to run the WAVE browser extension](https://hackforla.github.io/accessibility/getting-started/wave-browser-extension/)
119+
- 1.02 Application details
120+
- 1.02.01 User Profile Required: [REPLACE WITH USER TYPE: visitor (not logged in)/user/admin/security admin/]
121+
- 1.02.02 Page URL: http://tdm-dev.azurewebsites.net/[REPLACE WITH PAGE URL]
122+
- Requires sign in: [REPLACE WITH TRUE OR FALSE]
123+
- Can access page directly from URL: [REPLACE WITH TRUE OR FALSE]
124+
- 1.03 [TDM WAVE Accessibility Audit Spreadsheet, tab: 2. Audit Log, filter: Alert: [REPLACE WITH FILTER NAME]]
125+
- Spreadsheet Row(s): [REPLACE WITH ROW NUMBERS]
126+
- 1.04 https://hackforla.github.io/accessibility/getting-started/perform-wave-audit
127+
- 1.05 [Accessibility Known Issues Index](https://hackforla.github.io/accessibility/known-issues-and-solutions/solutions-index/)
128+
- 1.05.01 [WAVE Known Accessibility Issue: [REPLACE WITH ONE OF THESE CATEGORIES Alert/Aria/Contrast Error/Error] - [REPLACE WITH NAME OF Alert/Aria/Contrast Error/Error]]
129+
- 1.05.01.01 [WAVE Known Accessibility Issue: [REPLACE WITH ONE OF THESE CATEGORIES Alert/Aria/Contrast Error/Error] - [REPLACE WITH NAME OF Alert/Aria/Contrast Error/Error], project-team-solution]
130+
131+
Additional reading (optional)
132+
- TDM [Accessibility Audits](https://hackforla.github.io/accessibility/)
133+
134+
<!- DELETE THE SLIDES SECTION IF THIS IS NOT FOR THE TDM TEAM -->
135+
#### Slides
136+
- [Staging Deck](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg)
137+
- [Staging Deck, slide]
138+
- Release deck
139+
- [2026-01-20 Release deck, slide ]
140+
```
141+
142+
#### 1.05 Second Issue Template
143+
Title
144+
```
145+
Dev: fix [REPLACE WITH Alert/Aria/Contrast Error/Error] on [REPLACE WITH PAGE NAME] page
146+
```
147+
Body
148+
````
149+
### Overview
150+
We need to fix the Alert: [REPLACE WITH Alert/Aria/Contrast Error/Error](s) on [REPLACE WITH PAGE NAME] so that page can be WCAG compliant.
151+
152+
#### Details
153+
Category: [REPLACE WITH ONE OF THESE CATEGORIES Alert/Aria/Contrast Error/Error]
154+
Name: [REPLACE WITH NAME OF Alert/Aria/Contrast Error/Error]
155+
(The Accessibility wiki for this Alert has a solution)
156+
157+
Page that will be worked on:
158+
[REPLACE WITH NAME OF PAGE NAME]
159+
160+
### Action Items
161+
- [ ] Review wiki page: Accessibility, How to run the WAVE browser extension (Resource 1.01)
162+
- [ ] Install the WAVE browser extension
163+
- [ ] Log in as the user indicated (resource 1.02.01)
164+
- [ ] navigate to the page you are going to fix (resource 1.02.02)
165+
- [ ] Open the TDM WAVE Accessibility Audit Spreadsheet, for this Alert (resource 1.03) and find the row that relates to this issues page.
166+
- [ ] Run the WAVE extension with no elements focused, or clicked
167+
- [ ] Find the Alert referenced in the Spreadsheet (1.03)
168+
- [ ] This alert has been resolved on other pages, so review `Project Team Solution` section (resource 1.04.01.01)
169+
- [ ] Apply solution
170+
- [ ] Submit PR
171+
- [ ] Add PR to spreadsheet in PR column next to Alert (resource 1.03)
172+
- [ ] On this issue
173+
- [ ] Add labels:
174+
- `ready for accessibility lead`
175+
- [ ] Change status to: `Technical Review`
176+
- to the epic #2897
177+
- [ ] Add the label `ready for product`
178+
- [ ] Add this comment
179+
```
180+
- [#REPLACE WITH THIS ISSUE NUMBER] is closed. Please review to see if there are any remaining instances of this problem
181+
```
182+
183+
### Resources/Instructions
184+
- 1.01[How to run the WAVE browser extension](https://github.com/hackforla/accessibility/blob/main/docs/getting-started/wave-browser-extension.md)
185+
- 1.02 Application details
186+
- 1.02.01 User Profile Required: [REPLACE WITH USER TYPE: visitor (not logged in)/user/admin/security admin/]
187+
- 1.02.02 Page URL: http://tdm-dev.azurewebsites.net/[REPLACE WITH PAGE URL]
188+
- Requires sign in: [REPLACE WITH TRUE OR FALSE]
189+
- Can access page directly from URL: [REPLACE WITH TRUE OR FALSE]
190+
- 1.03 [TDM WAVE Accessibility Audit Spreadsheet, tab: 2. Audit Log, filter: Alert: [REPLACE WITH FILTER NAME]]
191+
- Spreadsheet Row(s): [REPLACE WITH ROW NUMBERS]
192+
- 1.04 [Accessibility Known Issues Index](https://github.com/hackforla/accessibility/blob/main/docs/known-issues-and-solutions/solutions-index/index.md)
193+
- 1.04.01 [WAVE Known Accessibility Issue: [REPLACE WITH ONE OF THESE CATEGORIES Alert/Aria/Contrast Error/Error] - [REPLACE WITH NAME OF Alert/Aria/Contrast Error/Error]]
194+
- 1.04.01.01 [WAVE Known Accessibility Issue: [REPLACE WITH ONE OF THESE CATEGORIES Alert/Aria/Contrast Error/Error] - [REPLACE WITH NAME OF Alert/Aria/Contrast Error/Error], project-team-solution]
195+
196+
Additional reading (optional)
197+
- https://hackforla.github.io/accessibility/
198+
199+
#### Slides
200+
- [Staging Deck](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg)
201+
- [Staging Deck, slide ]
202+
- Release deck
203+
- [2026-01-20 Release deck, slide ]
204+
````
205+
206+
<!- DELETE THE SLIDES SECTION IF THIS IS NOT FOR THE TDM TEAM -->
207+
#### Slides
208+
- [Staging Deck](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg)
209+
- [Staging Deck, slide 2897] - N/A
210+
- Release deck
211+
- [2026-01-20 Release deck, slide 2897] - N/A

0 commit comments

Comments
 (0)