WCAG 2.2 AA: replace badge images with text, add live count via JS, remove emojis, linkify all resources

Author: accesswatch

.github/workflows/registration.yml

@@ -26,12 +26,12 @@ jobs:
               owner: context.repo.owner,
               repo: context.repo.repo,
               issue_number: context.issue.number,
-              body: `## ✅ You are registered for GIT Going with GitHub!
+              body: `## You are registered for GIT Going with GitHub!
 
             Welcome, @${context.payload.issue.user.login}! Your registration has been received.
 
             **Workshop details:**
-            - 📅 **Dates:** Friday, March 6 & Saturday, March 7, 2026
+            - **Dates:** Friday, March 6 & Saturday, March 7, 2026
             - 🕛 **Time:** 12:00 PM — 8:00 PM Eastern (both days)
             - 📍 **Location:** Online via Zoom (link will be emailed before the event)
 
@@ -40,7 +40,7 @@ jobs:
             2. Watch for an email with your Zoom join link
             3. Questions? Email [support@bits-acb.org](mailto:support@bits-acb.org)
 
-            You just filed a GitHub issue — your first open source contribution. Welcome to the community. 🎉`
+            You just filed a GitHub issue — your first open source contribution. Welcome to the community.`
             });
 
       - name: Add registration label

ANNOUNCEMENT.md

@@ -1,8 +1,6 @@
 # GIT Going with GitHub
 
-![License: CC BY 4.0](https://img.shields.io/badge/License-CC%20BY%204.0-lightgrey.svg?style=flat-square)
-![GitHub Pages](https://img.shields.io/github/actions/workflow/status/BITS-ACB/git-going-with-github/deploy-pages.yml?label=Site&style=flat-square)
-![Registration Count](https://img.shields.io/github/issues/BITS-ACB/git-going-with-github/registration?label=Registered&color=brightgreen&style=flat-square)
+[License: CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) | [View Site](https://bits-acb.github.io/git-going-with-github/) | [Full Curriculum](https://bits-acb.github.io/git-going-with-github/docs/course-guide.html) | [Discussion Forum](https://github.com/BITS-ACB/git-going-with-github/discussions) | [Register](https://github.com/BITS-ACB/git-going-with-github/issues/new?template=workshop-registration.yml&title=%5BREGISTER%5D+GIT+Going+with+GitHub+%E2%80%94+March+2026)
 
 ## You Belong in Open Source. Let Us Show You the Door.
 
@@ -12,20 +10,20 @@
 |---|---|
 | **Dates** | Friday, March 6 & Saturday, March 7, 2026 |
 | **Time** | 12:00 PM — 8:00 PM Eastern (both days) |
-| **Location** | Online via Zoom |
+| **Location** | Online via [Zoom](https://zoom.us/) |
 | **Cost** | Free |
 | **Capacity** | 75 participants (limited seats) |
 | **Presented by** | [BITS — Blind Information Technology Solutions](http://www.joinbits.org) |
 
-### ![Registration Count](https://img.shields.io/github/issues/BITS-ACB/git-going-with-github/registration?label=%E2%9C%85%20Registered&color=brightgreen&style=for-the-badge) out of 75 spots
+### Registered: <span id="registration-count" aria-live="polite">loading...</span> out of 75 spots
 
 ---
 
 > **Registration is open!** [**Register now**](https://github.com/BITS-ACB/git-going-with-github/issues/new?template=workshop-registration.yml&title=%5BREGISTER%5D+GIT+Going+with+GitHub+%E2%80%94+March+2026) — sign up by filing a GitHub issue. It only takes a minute.
 
 ---
 
-> **📣 Join the conversation!** Have a question before the workshop? Want to connect with other participants? Head to our [**Discussion Forum**](https://github.com/BITS-ACB/git-going-with-github/discussions) — introduce yourself, ask questions, and start building your network before Day 1.
+> **Join the conversation!** Have a question before the workshop? Want to connect with other participants? Head to our [**Discussion Forum**](https://github.com/BITS-ACB/git-going-with-github/discussions) — introduce yourself, ask questions, and start building your network before Day 1.
 
 ---
 
@@ -50,7 +48,7 @@ This workshop exists because open source software powers the world — and the p
 This workshop is designed for:
 
 - **Blind and low vision individuals** who want to learn GitHub and open source contribution
-- **Screen reader users** (NVDA, JAWS, or VoiceOver) at any skill level
+- **Screen reader users** ([NVDA](https://www.nvaccess.org/download/), [JAWS](https://www.freedomscientific.com/products/software/jaws/), or [VoiceOver](https://support.apple.com/guide/voiceover/welcome/mac)) at any skill level
 - **People who have never used GitHub before** — no prior experience required
 - **Developers who use assistive technology** and want to sharpen their open source workflow
 - **Anyone curious about accessible development** — sighted participants are welcome; all content is fully keyboard-navigable
@@ -66,7 +64,7 @@ By the end of this workshop, you will have:
 - Filed real issues on a real GitHub repository
 - Opened, reviewed, and merged real pull requests
 - Your name permanently in the commit history of a public accessibility project
-- A working VS Code setup with GitHub Copilot and six AI agents configured
+- A working [VS Code](https://code.visualstudio.com/) setup with [GitHub Copilot](https://github.com/features/copilot) and six AI agents configured
 - The confidence to navigate any GitHub repository with your screen reader
 - A network of peers who understand the intersection of accessibility and open source
 
@@ -76,36 +74,36 @@ These are not hypothetical outcomes. Every participant ships something real.
 
 ## The Two-Day Journey
 
-### Day 1 — GitHub Foundations (Browser + Screen Reader)
+### [Day 1 — GitHub Foundations (Browser + Screen Reader)](https://bits-acb.github.io/git-going-with-github/DAY1_AGENDA.html)
 
 Your screen reader and keyboard are the only tools you need. Everything happens in the browser.
 
 | Block | What Happens |
 |-------|-------------|
-| **Welcome and Setup Check** | Introductions, verify everyone's screen reader and browser are ready |
-| **Screen Reader Orientation to GitHub** | Navigate GitHub pages using headings, landmarks, and keyboard shortcuts |
-| **Navigating Repositories** | Explore a real repository — files, branches, commits, contributors |
-| **Working with Issues** | Search, file, comment on, and triage issues using Markdown |
-| **Understanding Pull Requests** | Read diffs, write inline review comments, approve and merge |
-| **Your First Contribution Sprint** | Make a real contribution to the shared practice repository — with automated bot feedback and human peer review |
-| **Community and Culture** | Open source etiquette, constructive feedback, managing notifications, organizing with labels |
+| **[Welcome and Setup Check](https://bits-acb.github.io/git-going-with-github/docs/00-pre-workshop-setup.html)** | Introductions, verify everyone's screen reader and browser are ready |
+| **[Screen Reader Orientation to GitHub](https://bits-acb.github.io/git-going-with-github/docs/01-understanding-github-web-structure.html)** | Navigate GitHub pages using headings, landmarks, and keyboard shortcuts |
+| **[Navigating Repositories](https://bits-acb.github.io/git-going-with-github/docs/02-navigating-repositories.html)** | Explore a real repository — files, branches, commits, contributors |
+| **[Working with Issues](https://bits-acb.github.io/git-going-with-github/docs/04-working-with-issues.html)** | Search, file, comment on, and triage issues using [Markdown](https://bits-acb.github.io/git-going-with-github/docs/appendix-e-github-flavored-markdown.html) |
+| **[Understanding Pull Requests](https://bits-acb.github.io/git-going-with-github/docs/05-working-with-pull-requests.html)** | Read diffs, write inline review comments, approve and merge |
+| **[Your First Contribution Sprint](https://bits-acb.github.io/git-going-with-github/learning-room/)** | Make a real contribution to the shared practice repository — with automated bot feedback and human peer review |
+| **[Community and Culture](https://bits-acb.github.io/git-going-with-github/docs/07-culture-etiquette.html)** | Open source etiquette, constructive feedback, [managing notifications](https://bits-acb.github.io/git-going-with-github/docs/09-notifications.html), organizing with [labels](https://bits-acb.github.io/git-going-with-github/docs/08-labels-milestones-projects.html) |
 
-You will also work through GitHub Skills modules — interactive, bot-guided courses that run in your own GitHub account. A bot named Mona creates real issues and pull requests for you, verifies your actions, and guides you through each step. It is the same mechanism used by real open source projects.
+You will also work through [GitHub Skills](https://skills.github.com/) modules — interactive, bot-guided courses that run in your own GitHub account. A bot named Mona creates real issues and pull requests for you, verifies your actions, and guides you through each step. It is the same mechanism used by real open source projects.
 
-### Day 2 — From Contributor to Product Maker (VS Code + Agent Forge)
+### [Day 2 — From Contributor to Product Maker (VS Code + Agent Forge)](https://bits-acb.github.io/git-going-with-github/DAY2_AGENDA.html)
 
 You earned the tools. Now you wield them.
 
 | Block | What Happens |
 |-------|-------------|
 | **Day 1 Debrief** | Celebrate what shipped, surface questions, set your Day 2 goal |
-| **VS Code Setup** | Screen reader mode, workspace navigation, the bridge from browser to editor |
-| **Deep Contribution with Copilot** | Use GitHub Copilot as a writing partner — draft improvements, review your own work, commit with confidence |
-| **Activate the Agents** | Run six AI agents that amplify every skill you built on Day 1 — daily briefings, issue triage, PR review, accessibility monitoring |
-| **Ship Your Contribution** | Open a real pull request to a live public repository. Your facilitator reviews and merges it. |
+| **[VS Code Setup](https://bits-acb.github.io/git-going-with-github/docs/10-vscode-basics.html)** | Screen reader mode, workspace navigation, the bridge from browser to editor |
+| **[Deep Contribution with Copilot](https://bits-acb.github.io/git-going-with-github/docs/13-github-copilot.html)** | Use [GitHub Copilot](https://github.com/features/copilot) as a writing partner — draft improvements, review your own work, commit with confidence |
+| **[Activate the Agents](https://bits-acb.github.io/git-going-with-github/docs/16-agent-forge.html)** | Run six AI agents that amplify every skill you built on Day 1 — daily briefings, issue triage, PR review, accessibility monitoring |
+| **[Ship Your Contribution](https://bits-acb.github.io/git-going-with-github/docs/12-github-pull-requests-extension.html)** | Open a real pull request to a live public repository. Your facilitator reviews and merges it. |
 | **Design the Future** | Collaborative speccing session — what should the next version of these tools look like? Your ideas, on the record. |
 
-The central project is **Agent Forge** — a real, MIT-licensed open source project with six GitHub Copilot agents and 28 slash commands for accessible repository management. You will fork it, understand it, improve it, and personalize it.
+The central project is **[Agent Forge](https://bits-acb.github.io/git-going-with-github/docs/16-agent-forge.html)** — a real, MIT-licensed open source project with six [GitHub Copilot](https://github.com/features/copilot) agents and 28 slash commands for accessible repository management. You will fork it, understand it, improve it, and personalize it.
 
 ---
 
@@ -125,18 +123,18 @@ You need one of the following. Use whichever you are most comfortable with.
 
 | Screen Reader | Platform | Cost | Where to Get It |
 |---------------|----------|------|-----------------|
-| **NVDA** | Windows | Free | [nvaccess.org/download](https://www.nvaccess.org/download/) |
-| **JAWS** | Windows | Paid (40-minute trial available) | [freedomscientific.com](https://www.freedomscientific.com/products/software/jaws/) |
-| **VoiceOver** | macOS | Built-in (free) | Already on your Mac — press Cmd+F5 to activate |
+| **[NVDA](https://www.nvaccess.org/download/)** | Windows | Free | [nvaccess.org/download](https://www.nvaccess.org/download/) |
+| **[JAWS](https://www.freedomscientific.com/products/software/jaws/)** | Windows | Paid (40-minute trial available) | [freedomscientific.com](https://www.freedomscientific.com/products/software/jaws/) |
+| **[VoiceOver](https://support.apple.com/guide/voiceover/welcome/mac)** | macOS | Built-in (free) | Already on your Mac — press Cmd+F5 to activate |
 
 All exercises work with any of these. Where keyboard commands differ, we provide all three.
 
 ### Web Browser
 
 | Platform | Recommended |
 |----------|-------------|
-| Windows | Chrome or Firefox (Edge also works) |
-| macOS | Safari (best VoiceOver support) or Firefox |
+| Windows | [Chrome](https://www.google.com/chrome/) or [Firefox](https://www.mozilla.org/firefox/) ([Edge](https://www.microsoft.com/edge) also works) |
+| macOS | [Safari](https://www.apple.com/safari/) (best VoiceOver support) or [Firefox](https://www.mozilla.org/firefox/) |
 
 ### Software to Install
 
@@ -204,14 +202,14 @@ You will need a free GitHub account to register (see prerequisites above). The f
 - Your experience level with GitHub
 - Any questions you have before the workshop
 
-![Registration Count](https://img.shields.io/github/issues/BITS-ACB/git-going-with-github/registration?label=Registered&color=brightgreen&style=for-the-badge) out of 75 spots
+Registered: <span id="registration-count-2" aria-live="polite">loading...</span> out of 75 spots
 
 ### Zoom Link
 
 Zoom join links will be emailed to all registered participants before the workshop.
 
 **Zoom accessibility notes:**
-- The Zoom client works well with NVDA, JAWS, and VoiceOver
+- The [Zoom](https://zoom.us/) client works well with [NVDA](https://www.nvaccess.org/download/), [JAWS](https://www.freedomscientific.com/products/software/jaws/), and [VoiceOver](https://support.apple.com/guide/voiceover/welcome/mac)
 - If you need a sign language interpreter or any other accommodation, note it in the registration form and we will arrange it
 
 ---
@@ -224,7 +222,7 @@ Every step in this workshop is written three ways — for NVDA, for JAWS, and fo
 
 And the goal is not just "learn GitHub." The goal is to move you from **user** to **maker**. From someone who encounters accessibility barriers to someone who files the issue, proposes the fix, reviews the pull request, and ships the solution. That arc — from observer to contributor to product maker — is what the two days are designed to deliver.
 
-The curriculum includes 17 chapters, 25 reference appendices, 24 hands-on exercises, a shared practice repository with automated feedback bots, three GitHub Skills modules with a bot that verifies your work in real time, and a live open source project where your contributions are merged on Day 2.
+The curriculum includes [17 chapters](https://bits-acb.github.io/git-going-with-github/docs/course-guide.html), [25 reference appendices](https://bits-acb.github.io/git-going-with-github/docs/appendix-a-glossary.html), 24 hands-on exercises, a shared [practice repository](https://bits-acb.github.io/git-going-with-github/learning-room/) with automated feedback bots, three [GitHub Skills](https://skills.github.com/) modules with a bot that verifies your work in real time, and a live open source project where your contributions are merged on Day 2.
 
 All of it is open source. All of it is yours to keep, fork, and share.
 

README.md

@@ -1,9 +1,6 @@
 # GIT Going with GitHub
 
-![License: CC BY 4.0](https://img.shields.io/badge/License-CC%20BY%204.0-lightgrey.svg?style=flat-square)
-![GitHub Pages](https://img.shields.io/github/actions/workflow/status/BITS-ACB/git-going-with-github/deploy-pages.yml?label=Site&style=flat-square)
-![Registration Count](https://img.shields.io/github/issues/BITS-ACB/git-going-with-github/registration?label=Registered&color=brightgreen&style=flat-square)
-![GitHub Discussions](https://img.shields.io/github/discussions/BITS-ACB/git-going-with-github?label=Discussions&style=flat-square&color=blueviolet)
+License: CC BY 4.0 | [Site](https://bits-acb.github.io/git-going-with-github/) | [Discussions](https://github.com/BITS-ACB/git-going-with-github/discussions)
 
 ## A Workshop by [BITS (Blind Information Technology Solutions)](http://www.joinbits.org)
 
@@ -13,11 +10,11 @@
 
 | | |
 |---|---|
-| 🌐 **Workshop site** | [bits-acb.github.io/git-going-with-github](https://bits-acb.github.io/git-going-with-github/) |
-| 📝 **Register** | [Sign up now](https://github.com/BITS-ACB/git-going-with-github/issues/new?template=workshop-registration.yml&title=%5BREGISTER%5D+) (75 seats, free) |
-| 💬 **Discussions** | [Join the conversation](https://github.com/BITS-ACB/git-going-with-github/discussions) |
-| 📧 **Email** | [support@bits-acb.org](mailto:support@bits-acb.org) |
-| 📅 **Dates** | March 6–7, 2026 · 12–8 PM Eastern |
+| **Workshop site** | [bits-acb.github.io/git-going-with-github](https://bits-acb.github.io/git-going-with-github/) |
+| **Register** | [Sign up now](https://github.com/BITS-ACB/git-going-with-github/issues/new?template=workshop-registration.yml&title=%5BREGISTER%5D+) (75 seats, free) |
+| **Discussions** | [Join the conversation](https://github.com/BITS-ACB/git-going-with-github/discussions) |
+| **Email** | [support@bits-acb.org](mailto:support@bits-acb.org) |
+| **Dates** | March 6–7, 2026 · 12–8 PM Eastern |
 
 ---
 

html/ACCESSIBILITY_TESTING.html

@@ -382,5 +382,5 @@ <h2>Questions or Feedback?</h2>
     <p><strong>GIT Going with GitHub</strong> — A workshop by <a href="http://www.joinbits.org">BITS (Blind Information Technology Solutions)</a></p>
     <p><a href="https://github.com/BITS-ACB/git-going-with-github">View on GitHub</a> · <a href="http://www.joinbits.org">joinbits.org</a></p>
   </footer>
-</body>
+  </body>
 </html>

html/BUILD.html

@@ -144,5 +144,5 @@ <h2>Additional Resources</h2>
     <p><strong>GIT Going with GitHub</strong> — A workshop by <a href="http://www.joinbits.org">BITS (Blind Information Technology Solutions)</a></p>
     <p><a href="https://github.com/BITS-ACB/git-going-with-github">View on GitHub</a> · <a href="http://www.joinbits.org">joinbits.org</a></p>
   </footer>
-</body>
+  </body>
 </html>

html/CODE_OF_CONDUCT.html

@@ -104,5 +104,5 @@ <h2>Attribution</h2>
     <p><strong>GIT Going with GitHub</strong> — A workshop by <a href="http://www.joinbits.org">BITS (Blind Information Technology Solutions)</a></p>
     <p><a href="https://github.com/BITS-ACB/git-going-with-github">View on GitHub</a> · <a href="http://www.joinbits.org">joinbits.org</a></p>
   </footer>
-</body>
+  </body>
 </html>

html/CONTRIBUTING.html

@@ -383,5 +383,5 @@ <h2>11. Questions and Discussion</h2>
     <p><strong>GIT Going with GitHub</strong> — A workshop by <a href="http://www.joinbits.org">BITS (Blind Information Technology Solutions)</a></p>
     <p><a href="https://github.com/BITS-ACB/git-going-with-github">View on GitHub</a> · <a href="http://www.joinbits.org">joinbits.org</a></p>
   </footer>
-</body>
+  </body>
 </html>

html/DAY1_AGENDA.html

@@ -720,5 +720,5 @@ <h3>Pacing Tips for Skills Modules</h3>
     <p><strong>GIT Going with GitHub</strong> — A workshop by <a href="http://www.joinbits.org">BITS (Blind Information Technology Solutions)</a></p>
     <p><a href="https://github.com/BITS-ACB/git-going-with-github">View on GitHub</a> · <a href="http://www.joinbits.org">joinbits.org</a></p>
   </footer>
-</body>
+  </body>
 </html>

html/DAY2_AGENDA.html

@@ -646,5 +646,5 @@ <h3>The Emotional Arc</h3>
     <p><strong>GIT Going with GitHub</strong> — A workshop by <a href="http://www.joinbits.org">BITS (Blind Information Technology Solutions)</a></p>
     <p><a href="https://github.com/BITS-ACB/git-going-with-github">View on GitHub</a> · <a href="http://www.joinbits.org">joinbits.org</a></p>
   </footer>
-</body>
+  </body>
 </html>

html/FACILITATOR.html

@@ -603,5 +603,5 @@ <h2>Personalizing This Workshop</h2>
     <p><strong>GIT Going with GitHub</strong> — A workshop by <a href="http://www.joinbits.org">BITS (Blind Information Technology Solutions)</a></p>
     <p><a href="https://github.com/BITS-ACB/git-going-with-github">View on GitHub</a> · <a href="http://www.joinbits.org">joinbits.org</a></p>
   </footer>
-</body>
+  </body>
 </html>