1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142name: Accessibility issue
description: Report an accessibility barrier in the Iris app/demo or in the HTML it produces.
title: "[a11y]: <short description of the issue>"
labels: ["accessibility"]
body:
- type: markdown
attributes:
value: |
Thanks for taking the time to report an accessibility issue. Reports like yours help keep Equalify Iris — and the HTML it generates — usable by everyone.
Share as much as you're comfortable with; partial reports are still useful. If you use assistive technology, feel free to describe what you experienced in your own words.
- type: dropdown
id: where
attributes:
label: Where did you find this?
description: |
- **The app / demo interface** — the Equalify Iris web UI itself.
- **The converted HTML output** — the accessible HTML Iris produced from a document.
options:
- The app / demo interface
- The converted HTML output
- Other / not sure
validations:
required: true
- type: textarea
id: summary
attributes:
label: Summary
description: A brief description of the accessibility barrier you encountered.
placeholder: "Example: A converted form's radio group has no <fieldset>/<legend>, so my screen reader doesn't announce what the options belong to."
validations:
required: true
- type: textarea
id: source
attributes:
label: Source document (for converted-output issues)
description: If this is about converted HTML, what kind of document was it (form, table, multi-column page, scanned PDF, etc.)? Attaching the source page image/PDF or the produced HTML helps a lot.
validations:
required: false
- type: textarea
id: expected
attributes:
label: Expected behavior
description: What did you expect to happen?
validations:
required: true
- type: textarea
id: actual
attributes:
label: Actual behavior
description: What actually happened?
validations:
required: true
- type: textarea
id: steps
attributes:
label: Steps to reproduce
description: How can we reproduce the issue? A screen recording or screenshot is optional but very helpful.
placeholder: |
1. Go to https://iris.equalify.foundation/
2. Upload …
3. Tab to … / open the converted document and …
4. Observe that …
validations:
required: true
- type: dropdown
id: severity
attributes:
label: Severity (revised during triage as needed)
description: |
How much does this affect your ability to use Iris or its output?
- **Critical:** Blocks a core task entirely.
- **High:** Significant difficulty, but a workaround exists.
- **Medium:** Annoyance or inconsistent experience.
- **Low:** Minor issue with minimal impact.
options:
- Critical
- High
- Medium
- Low
validations:
required: true
- type: input
id: os
attributes:
label: Operating system and version
placeholder: "macOS 14.5, Windows 11, iOS 17, Android 14, Ubuntu 22.04"
validations:
required: false
- type: input
id: browser
attributes:
label: Browser and version
placeholder: "Chrome 124, Firefox 125, Safari 17.4, Edge 124"
validations:
required: false
- type: input
id: assistive-tech
attributes:
label: Assistive technology and version
description: If assistive technology was used, please tell us which one(s) and which version(s).
placeholder: "VoiceOver (macOS 14.5), NVDA 2024.1, JAWS 2024, TalkBack on Android 14"
validations:
required: false
- type: textarea
id: wcag
attributes:
label: Related WCAG criteria (optional)
description: |
If you know which [WCAG 2.2](https://www.w3.org/TR/WCAG22/) success criteria this relates to, please share. Don't worry if you're not sure — we'll figure it out during triage.
placeholder: "1.3.1 Info and Relationships, 2.4.7 Focus Visible, 4.1.2 Name, Role, Value"
validations:
required: false
- type: textarea
id: additional-context
attributes:
label: Additional context
description: Anything else we should know? Screenshots, recordings, related issues, or workarounds you've tried.
validations:
required: false
- type: checkboxes
id: code-of-conduct
attributes:
label: Code of Conduct
description: By submitting this issue, you agree to follow our [Code of Conduct](../blob/main/CODE_OF_CONDUCT.md).
options:
- label: I agree to follow this project's Code of Conduct.
required: true