Skip to content

Commit 247e19b

Browse files
taylorarndttaylorarndt
authored
Merge pull request #170 from Community-Access/feature/pages-search
Add full-text search to GitHub Pages site
2 parents 1fff107 + 766aa95 commit 247e19b

File tree

132 files changed

+10528
-5461
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

132 files changed

+10528
-5461
lines changed

‎.github/ISSUE_TEMPLATE/wiki-issue.yml‎

Lines changed: 93 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,93 @@
1+
name: Wiki Issue
2+
description: Report a problem with a wiki page — wrong info, broken content, missing section, or accessibility issue
3+
labels: ["wiki", "needs triage"]
4+
assignees: ["taylorarndt"]
5+
body:
6+
- type: markdown
7+
attributes:
8+
value: |
9+
Thanks for helping improve the wiki! Answer as many questions as you can — every detail helps us find and fix the problem faster.
10+
11+
- type: input
12+
id: page
13+
attributes:
14+
label: Which wiki page has the issue?
15+
description: Paste the URL or the page title
16+
placeholder: "e.g. https://github.com/Community-Access/git-going-with-github/wiki/03-the-learning-room"
17+
validations:
18+
required: true
19+
20+
- type: dropdown
21+
id: issue-type
22+
attributes:
23+
label: What kind of problem is it?
24+
options:
25+
- Wrong or outdated information
26+
- Broken or missing image / diagram
27+
- Formatting looks broken
28+
- Link is broken or goes to the wrong place
29+
- Content is hard to understand
30+
- Accessibility issue (screen reader, keyboard, contrast)
31+
- Missing content or section
32+
- Something else
33+
validations:
34+
required: true
35+
36+
- type: textarea
37+
id: what-is-wrong
38+
attributes:
39+
label: What is wrong?
40+
description: Describe exactly what you see that looks incorrect or broken
41+
placeholder: "e.g. The diagram image doesn't load, it shows a broken image icon instead of the SVG..."
42+
validations:
43+
required: true
44+
45+
- type: textarea
46+
id: what-expected
47+
attributes:
48+
label: What should it look like or say instead?
49+
description: Tell us what the correct content or behaviour should be
50+
placeholder: "e.g. The diagram should show a tree structure of the repository layout..."
51+
validations:
52+
required: false
53+
54+
- type: dropdown
55+
id: how-accessing
56+
attributes:
57+
label: How were you viewing the wiki?
58+
options:
59+
- GitHub website (browser)
60+
- GitHub mobile app
61+
- Screen reader (NVDA, JAWS, VoiceOver, etc.)
62+
- Keyboard only (no mouse)
63+
- Other assistive technology
64+
validations:
65+
required: false
66+
67+
- type: input
68+
id: assistive-tech
69+
attributes:
70+
label: If you use a screen reader or assistive technology, which one?
71+
placeholder: "e.g. NVDA with Firefox, VoiceOver with Safari, JAWS with Chrome"
72+
validations:
73+
required: false
74+
75+
- type: textarea
76+
id: steps
77+
attributes:
78+
label: Steps to reproduce
79+
description: How do we find the problem ourselves?
80+
placeholder: |
81+
1. Go to the wiki page...
82+
2. Scroll to the section...
83+
3. The image / link / text shows...
84+
validations:
85+
required: false
86+
87+
- type: textarea
88+
id: anything-else
89+
attributes:
90+
label: Anything else we should know?
91+
description: Screenshots, extra context, or related pages with the same issue
92+
validations:
93+
required: false

‎FACILITATOR.md‎

Lines changed: 56 additions & 56 deletions
Original file line numberDiff line numberDiff line change
@@ -81,62 +81,62 @@
8181
This is the single repository students clone. Everything they need for both days is here:
8282

8383
```
84-
learning-room/ ← workshop repository root
85-
├── README.md ← participant-facing start page
86-
├── CONTRIBUTING.md ← contribution guide
87-
├── CODE_OF_CONDUCT.md ← community standards
88-
├── FACILITATOR.md ← this file
89-
├── .gitignore
90-
├── .github/
91-
│ ├── ISSUE_TEMPLATE/
92-
│ │ ├── config.yml ← disables blank issues, links to Skills modules
93-
│ │ ├── accessibility-bug.yml ← accessibility bug report YAML form
94-
│ │ └── feature-request.yml ← feature/improvement request YAML form
95-
│ ├── PULL_REQUEST_TEMPLATE.md ← PR template with accessibility checklist
96-
│ ├── agents/ ← Accessibility Agents - 55 Copilot agents across 3 teams
97-
│ │ ├── daily-briefing.agent.md
98-
│ │ ├── issue-tracker.agent.md
99-
│ │ ├── pr-review.agent.md
100-
│ │ ├── analytics.agent.md
101-
│ │ ├── insiders-a11y-tracker.agent.md
102-
│ │ ├── template-builder.agent.md
103-
│ │ └── preferences.example.md
104-
│ └── prompts/ ← 54+ slash commands for Copilot Chat
105-
│ ├── a11y-update.prompt.md
106-
│ ├── create-issue.prompt.md
107-
│ ├── daily-briefing.prompt.md
108-
│ ├── explain-code.prompt.md
109-
│ ├── review-pr.prompt.md
110-
│ ├── triage.prompt.md
111-
│ └── ... (48 more - see docs/appendix-v-accessibility-agents-reference.md)
112-
├── docs/ ← full workshop curriculum (16 chapters + appendices A-X)
113-
│ ├── 00-pre-workshop-setup.md
114-
│ ├── 01-understanding-github-web-structure.md
115-
│ ├── 02-navigating-repositories.md
116-
│ ├── 03-the-learning-room.md
117-
│ ├── 04-working-with-issues.md
118-
│ ├── 05-working-with-pull-requests.md
119-
│ ├── 06-merge-conflicts.md
120-
│ ├── 07-culture-etiquette.md
121-
│ ├── 08-labels-milestones-projects.md
122-
│ ├── 09-notifications.md
123-
│ ├── 10-vscode-basics.md
124-
│ ├── 11-git-source-control.md
125-
│ ├── 12-github-pull-requests-extension.md
126-
│ ├── 13-github-copilot.md
127-
│ ├── 14-accessible-code-review.md
128-
│ ├── 15-issue-templates.md
129-
│ ├── 16-accessibility-agents.md
130-
│ ├── appendix-a-glossary.md ← every term explained
131-
│ ├── appendix-b-screen-reader-cheatsheet.md ← full shortcut reference
132-
│ ├── appendix-c through appendix-x ← deep-dive references (C-X)
133-
│ └── (see appendix-u-resources.md for complete file listing)
134-
└── learning-room/ ← practice content (contribution sprint targets)
135-
├── README.md
136-
└── docs/
137-
├── welcome.md ← has [TODO] gaps for participants to complete
138-
├── keyboard-shortcuts.md ← has intentional errors and a heading hierarchy problem
139-
└── setup-guide.md ← has a broken URL and [TODO] markers
84+
learning-room/ <- workshop repository root
85+
+-- README.md <- participant-facing start page
86+
+-- CONTRIBUTING.md <- contribution guide
87+
+-- CODE_OF_CONDUCT.md <- community standards
88+
+-- FACILITATOR.md <- this file
89+
+-- .gitignore
90+
+-- .github/
91+
| +-- ISSUE_TEMPLATE/
92+
| | +-- config.yml <- disables blank issues, links to Skills modules
93+
| | +-- accessibility-bug.yml <- accessibility bug report YAML form
94+
| | +-- feature-request.yml <- feature/improvement request YAML form
95+
| +-- PULL_REQUEST_TEMPLATE.md <- PR template with accessibility checklist
96+
| +-- agents/ <- Accessibility Agents - 55 Copilot agents across 3 teams
97+
| | +-- daily-briefing.agent.md
98+
| | +-- issue-tracker.agent.md
99+
| | +-- pr-review.agent.md
100+
| | +-- analytics.agent.md
101+
| | +-- insiders-a11y-tracker.agent.md
102+
| | +-- template-builder.agent.md
103+
| | +-- preferences.example.md
104+
| +-- prompts/ <- 54+ slash commands for Copilot Chat
105+
| +-- a11y-update.prompt.md
106+
| +-- create-issue.prompt.md
107+
| +-- daily-briefing.prompt.md
108+
| +-- explain-code.prompt.md
109+
| +-- review-pr.prompt.md
110+
| +-- triage.prompt.md
111+
| +-- ... (48 more - see docs/appendix-v-accessibility-agents-reference.md)
112+
+-- docs/ <- full workshop curriculum (16 chapters + appendices A-X)
113+
| +-- 00-pre-workshop-setup.md
114+
| +-- 01-understanding-github-web-structure.md
115+
| +-- 02-navigating-repositories.md
116+
| +-- 03-the-learning-room.md
117+
| +-- 04-working-with-issues.md
118+
| +-- 05-working-with-pull-requests.md
119+
| +-- 06-merge-conflicts.md
120+
| +-- 07-culture-etiquette.md
121+
| +-- 08-labels-milestones-projects.md
122+
| +-- 09-notifications.md
123+
| +-- 10-vscode-basics.md
124+
| +-- 11-git-source-control.md
125+
| +-- 12-github-pull-requests-extension.md
126+
| +-- 13-github-copilot.md
127+
| +-- 14-accessible-code-review.md
128+
| +-- 15-issue-templates.md
129+
| +-- 16-accessibility-agents.md
130+
| +-- appendix-a-glossary.md <- every term explained
131+
| +-- appendix-b-screen-reader-cheatsheet.md <- full shortcut reference
132+
| +-- appendix-c through appendix-x <- deep-dive references (C-X)
133+
| +-- (see appendix-u-resources.md for complete file listing)
134+
+-- learning-room/ <- practice content (contribution sprint targets)
135+
+-- README.md
136+
+-- docs/
137+
+-- welcome.md <- has [TODO] gaps for participants to complete
138+
+-- keyboard-shortcuts.md <- has intentional errors and a heading hierarchy problem
139+
+-- setup-guide.md <- has a broken URL and [TODO] markers
140140
```
141141

142142

‎html/ACCESSIBILITY_TESTING.html‎

Lines changed: 33 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -25,14 +25,42 @@
2525
</head>
2626
<body>
2727
<a class="skip-link" href="#main-content">Skip to main content</a>
28-
<nav aria-label="Breadcrumb" class="breadcrumb">
29-
<a href="./index.html">Home</a> <span aria-hidden="true">›</span> <span aria-current="page">Accessibility Testing Checklist</span>
30-
</nav>
28+
<header class="site-header" role="banner">
29+
<div class="site-header-inner">
30+
<nav aria-label="Breadcrumb" class="breadcrumb">
31+
<a href="./index.html">Home</a> <span aria-hidden="true">›</span> <span aria-current="page">Accessibility Testing Checklist</span>
32+
</nav>
33+
<div class="header-actions">
34+
<a href="https://github.com/Community-Access/git-going-with-github/wiki" class="wiki-link" target="_blank" rel="noopener noreferrer">
35+
<svg aria-hidden="true" focusable="false" width="16" height="16" viewBox="0 0 16 16" fill="currentColor">
36+
<path d="M1.75 1h8.5c.966 0 1.75.784 1.75 1.75v5.5A1.75 1.75 0 0 1 10.25 10H7.06l-2.573 2.573A1.458 1.458 0 0 1 2 11.543V10h-.25A1.75 1.75 0 0 1 0 8.25v-5.5C0 1.784.784 1 1.75 1ZM1.5 2.75v5.5c0 .138.112.25.25.25h1a.75.75 0 0 1 .75.75v2.19l2.72-2.72a.749.749 0 0 1 .53-.22h3.5a.25.25 0 0 0 .25-.25v-5.5a.25.25 0 0 0-.25-.25h-8.5a.25.25 0 0 0-.25.25Zm13 2a.25.25 0 0 0-.25-.25h-.5a.75.75 0 0 1 0-1.5h.5c.966 0 1.75.784 1.75 1.75v5.5A1.75 1.75 0 0 1 14.25 12H14v1.543a1.457 1.457 0 0 1-2.487 1.03L9.22 12.28a.749.749 0 1 1 1.06-1.06l2.22 2.22v-2.19a.75.75 0 0 1 .75-.75h.25a.25.25 0 0 0 .25-.25v-5.5Z"/>
37+
</svg>
38+
Wiki
39+
</a>
40+
<form role="search" class="search-form" action="./search.html" method="get">
41+
<label for="site-search" class="search-label">Search docs</label>
42+
<input
43+
type="search"
44+
id="site-search"
45+
class="search-input"
46+
name="q"
47+
placeholder="Search docs…"
48+
autocomplete="off"
49+
aria-label="Search documentation"
50+
>
51+
<button type="submit" class="search-button" aria-label="Submit search">
52+
<svg aria-hidden="true" focusable="false" width="16" height="16" viewBox="0 0 16 16" fill="currentColor">
53+
<path d="M10.68 11.74a6 6 0 0 1-7.922-8.982 6 6 0 0 1 8.982 7.922l3.04 3.04a.749.749 0 0 1-.326 1.275.749.749 0 0 1-.734-.215ZM11.5 7a4.499 4.499 0 1 0-8.997 0A4.499 4.499 0 0 0 11.5 7Z"/>
54+
</svg>
55+
</button>
56+
</form>
57+
</div>
58+
</div>
59+
</header>
3160
<main id="main-content" class="markdown-body">
3261
<h1>Accessibility Testing Checklist</h1>
3362
<h2>Verify GitHub Templates &amp; Workflows Are Accessible</h2>
3463
<p>This checklist helps you test issue templates, PRs, and GitHub workflows to ensure they&#39;re usable by people with disabilities (especially screen reader users).</p>
35-
<hr>
3664
<h2>Quick Checklist for Templates</h2>
3765
<p>Use before deploying any new issue template or form.</p>
3866
<h3>Form Fields &amp; Labels</h3>
@@ -66,7 +94,6 @@ <h3>YAML &amp; Technical</h3>
6694
<li><input aria-label="All required fields present:" disabled="" type="checkbox"> All required fields present: <code>name:</code>, <code>description:</code>, <code>body:</code></li>
6795
<li><input aria-label="Field IDs are unique and lowercase with hyphens (e.g.," disabled="" type="checkbox"> Field IDs are unique and lowercase with hyphens (e.g., <code>browser_type</code>)</li>
6896
</ul>
69-
<hr>
7097
<h2>Screen Reader Testing Workflow</h2>
7198
<h3>Before Testing</h3>
7299
<ol>
@@ -133,7 +160,6 @@ <h3>VoiceOver Testing (macOS)</h3>
133160
<li><input aria-label="Field labels are adjacent to fields" disabled="" type="checkbox"> Field labels are adjacent to fields</li>
134161
<li><input aria-label="Instructions are readable" disabled="" type="checkbox"> Instructions are readable</li>
135162
</ul>
136-
<hr>
137163
<h2>Accessibility Testing by Component</h2>
138164
<h3>Checkboxes &amp; Radio Buttons</h3>
139165
<ul>
@@ -176,7 +202,6 @@ <h3>Instructions &amp; Help Text</h3>
176202
<li><input aria-label="No abbreviations without explanation" disabled="" type="checkbox"> No abbreviations without explanation</li>
177203
</ul>
178204
<p><strong>Test:</strong> Tab to field, screen reader should announce label, field type, help text, and required status.</p>
179-
<hr>
180205
<h2>Color &amp; Contrast Testing</h2>
181206
<ul>
182207
<li><input aria-label="Text contrast is 4.5:1 or higher (WCAG AA for normal text)" disabled="" type="checkbox"> Text contrast is 4.5:1 or higher (WCAG AA for normal text)</li>
@@ -185,11 +210,10 @@ <h2>Color &amp; Contrast Testing</h2>
185210
<li>Example: Good: &quot;Error&quot; label + red color + error icon</li>
186211
</ul>
187212
</li>
188-
<li><input aria-label="Required fields marked with ✱ or &quot;required&quot; text (not just color)" disabled="" type="checkbox"> Required fields marked with ✱ or &quot;required&quot; text (not just color)</li>
213+
<li><input aria-label="Required fields marked with or &quot;required&quot; text (not just color)" disabled="" type="checkbox"> Required fields marked with or &quot;required&quot; text (not just color)</li>
189214
<li><input aria-label="Disabled fields are visually distinct" disabled="" type="checkbox"> Disabled fields are visually distinct</li>
190215
</ul>
191216
<p><strong>Test:</strong> Use WebAIM Contrast Checker: <a href="https://webaim.org/resources/contrastchecker/">https://webaim.org/resources/contrastchecker/</a></p>
192-
<hr>
193217
<h2>Keyboard Navigation Testing</h2>
194218
<p>Test WITHOUT using the mouse.</p>
195219
<ul>
@@ -203,7 +227,6 @@ <h2>Keyboard Navigation Testing</h2>
203227
<li><input aria-label="Can submit form with Enter from submit button" disabled="" type="checkbox"> Can submit form with Enter from submit button</li>
204228
</ul>
205229
<p><strong>Test:</strong> Close trackpad, use Tab/Shift+Tab/Enter/Space only.</p>
206-
<hr>
207230
<h2>Mobile &amp; Responsive Testing</h2>
208231
<ul>
209232
<li><input aria-label="Form is readable on small screens (mobile, tablet)" disabled="" type="checkbox"> Form is readable on small screens (mobile, tablet)</li>
@@ -213,7 +236,6 @@ <h2>Mobile &amp; Responsive Testing</h2>
213236
<li><input aria-label="No horizontal scrolling required to use form" disabled="" type="checkbox"> No horizontal scrolling required to use form</li>
214237
</ul>
215238
<p><strong>Test:</strong> Resize browser to mobile width (375px), or use phone/tablet to fill form.</p>
216-
<hr>
217239
<h2>Multilingual &amp; Plain Language Testing</h2>
218240
<ul>
219241
<li><input aria-label="Instructions use simple, clear language (avoid jargon)" disabled="" type="checkbox"> Instructions use simple, clear language (avoid jargon)</li>
@@ -222,7 +244,6 @@ <h2>Multilingual &amp; Plain Language Testing</h2>
222244
<li><input aria-label="If translated, consider cultural appropriateness of images/phrasings" disabled="" type="checkbox"> If translated, consider cultural appropriateness of images/phrasings</li>
223245
</ul>
224246
<p><strong>Test:</strong> Select browser zoom 200% (Ctrl+Plus / Cmd+Plus), or use browser reader mode.</p>
225-
<hr>
226247
<h2>Testing Checklist Summary</h2>
227248
<h3>Before Deploying (Must-Have)</h3>
228249
<ul>
@@ -248,7 +269,6 @@ <h3>Best Practice (Nice-to-Have)</h3>
248269
<li><input aria-label="Tested with actual users with disabilities" disabled="" type="checkbox"> Tested with actual users with disabilities</li>
249270
<li><input aria-label="Performance tested (forms load quickly)" disabled="" type="checkbox"> Performance tested (forms load quickly)</li>
250271
</ul>
251-
<hr>
252272
<h2>Common Accessibility Failures &amp; How to Test Them</h2>
253273
<table>
254274
<thead>
@@ -294,7 +314,6 @@ <h2>Common Accessibility Failures &amp; How to Test Them</h2>
294314
<td>Press Tab to first element; should offer &quot;skip to content&quot;</td>
295315
</tr>
296316
</tbody></table>
297-
<hr>
298317
<h2>Testing Tools &amp; Resources</h2>
299318
<h3>Automated Testing</h3>
300319
<ul>
@@ -316,7 +335,6 @@ <h3>Feedback</h3>
316335
<li><strong>WCAG Guidelines:</strong> <a href="https://www.w3.org/WAI/WCAG21/quickref/">https://www.w3.org/WAI/WCAG21/quickref/</a></li>
317336
<li><strong>Get Help:</strong> Open an issue with accessibility testing results</li>
318337
</ul>
319-
<hr>
320338
<h2>After Testing: Recording Issues</h2>
321339
<p>When you find an accessibility problem, document it:</p>
322340
<pre><code class="hljs"><span class="hljs-symbol">Title:</span> [Accessibility] Form label missing <span class="hljs-keyword">on</span> email field
@@ -339,7 +357,6 @@ <h2>After Testing: Recording Issues</h2>
339357
Screen reader tested: NVDA <span class="hljs-number">2025.3</span>.<span class="hljs-number">3</span>
340358
<span class="hljs-symbol">Browser:</span> Chrome <span class="hljs-number">130</span>
341359
<span class="hljs-symbol">OS:</span> Windows <span class="hljs-number">11</span></code></pre>
342-
<hr>
343360
<h2>Testing the Built HTML Output</h2>
344361
<p>This repository includes a build system that converts all Markdown files to HTML (see <code>BUILD.md</code>). If participants will use the HTML versions, test them separately:</p>
345362
<h3>Heading Hierarchy</h3>
@@ -367,14 +384,12 @@ <h3>Validation</h3>
367384
<li><input aria-label="Verify syntax-highlighted code blocks are readable (not color-only)" disabled="" type="checkbox"> Verify syntax-highlighted code blocks are readable (not color-only)</li>
368385
</ul>
369386
<p><strong>Quick test:</strong> Open <code>html/index.html</code> in a browser, enable your screen reader, and navigate using <code>H</code> (headings) and <code>K</code> (links). Every heading and link should be announced clearly.</p>
370-
<hr>
371387
<h2>Questions or Feedback?</h2>
372388
<ul>
373389
<li><strong>Having trouble testing?</strong> See <code>TROUBLESHOOTING.md</code></li>
374390
<li><strong>Need screen reader help?</strong> See <code>docs/appendix-b-screen-reader-cheatsheet.md</code></li>
375391
<li><strong>Want resources?</strong> See <code>docs/appendix-u-resources.md</code></li>
376392
</ul>
377-
<hr>
378393
<p><em>Last updated: February 2026</em><br><em>Accessibility is foundational to inclusive workflows.</em></p>
379394

380395
</main>

0 commit comments

Comments
 (0)