Context
#glossary-count has aria-live="polite" and its text is replaced on every keystroke. Updating a live region on every character produces a stream of interruptions, which in practice makes screen reader users turn it off or leave.
What to change
Files: js/glossary.js
Requirements:
- Debounce the announcement so it fires once the reader stops typing, not per character
- The visible count should still update immediately — only the announcement is debounced
- Roughly 300–500ms is the usual range; justify what you pick
- Do not remove the live region; the fix is timing, not deletion
Acceptance criteria
How to verify locally
python3 -m http.server 8000
Then open http://localhost:8000.
Difficulty
Intermediate. The contributor wall shares this problem.
New here? Comment /claim on this issue and a bot will assign it to you. Then read CONTRIBUTING.md.
Stuck at any point? Comment here saying what you have tried and where it stopped working — that is not an admission of failure, it is how we find out the instructions were unclear. You can also come to a PR Debug Clinic (Oct 12 or Oct 21).
Context
#glossary-counthasaria-live="polite"and its text is replaced on every keystroke. Updating a live region on every character produces a stream of interruptions, which in practice makes screen reader users turn it off or leave.What to change
Files:
js/glossary.jsRequirements:
Acceptance criteria
How to verify locally
Then open http://localhost:8000.
Difficulty
Intermediate. The contributor wall shares this problem.
New here? Comment
/claimon this issue and a bot will assign it to you. Then read CONTRIBUTING.md.Stuck at any point? Comment here saying what you have tried and where it stopped working — that is not an admission of failure, it is how we find out the instructions were unclear. You can also come to a PR Debug Clinic (Oct 12 or Oct 21).