Repository navigation
Description
What is wrong
The facilitator guides start many headings with an emoji, for example ## 🎯 Quick Navigation and ## 🚀 GitHub Classroom Setup (Before Day 1). A screen reader reads the emoji's name before the heading text ("direct hit Quick Navigation", "rocket GitHub Classroom Setup"), so the headings list is noisy and every heading is harder to find by its first letter. The house style in this repository is no emoji anywhere.
The documentation accessibility check (npm run check:accessibility) counts 26 emoji in admin/FACILITATOR_GUIDE.md and 20 in admin/FACILITATOR_RESOURCES.md.
Why this is a good first issue
It is text editing only, in two files, with a clear way to check your work. No code and no accessibility expertise needed.
What to do
- In
admin/FACILITATOR_GUIDE.mdandadmin/FACILITATOR_RESOURCES.md, remove each emoji, from headings and from running text. Where an emoji carried meaning (a warning sign before "Known Gotchas"), keep the meaning in words if the words do not already say it. - Removing an emoji from a heading changes its anchor:
#-github-classroom-setup-before-day-1becomes#github-classroom-setup-before-day-1. Update every link to a changed anchor, in the same file and in the other one.FACILITATOR_RESOURCES.mdlinks intoFACILITATOR_GUIDE.mdabout ten times. - Update the "Section-Level Source Map" at the end of each file so its headings match.
- Remove the two files' lines from
scripts/docs-accessibility-baseline.json(or runnode scripts/check-docs-accessibility.js --update-baselineand check that only these two files changed). - Run
npm run build:htmland commit the Markdown and the regeneratedhtml/together, as CONTRIBUTING.md describes.
Acceptance criteria
-
node scripts/check-docs-accessibility.js --report admin/FACILITATOR_GUIDE.md admin/FACILITATOR_RESOURCES.mdreports noemojifindings. - Every in-page link and every link between the two files still lands on its heading.
-
npm run check:accessibilityandnpm run validate:authoritative-sourcespass.
The other emoji the check found (admin/CURRICULUM_2.0_ORGANIZATION.md, admin/FACILITATOR_OPERATIONS.md) are a separate, later issue; leave them out of this one.
Generated by Claude Code
Activity
Fix documentation and site accessibility findings (#264-#268) (#271)