You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 924e04d
Browse filesBrowse the repository at this point in the historyBrowse files
authored
docs: resolve open issues 221/229/231 and retire stale Classroom seeding references (#241)
- Ch11 (#231): replace the Five Major Regions ASCII diagram with a real
markdown table; screen readers were announcing the box-drawing pipes as
broken tables.
- Ch6 (#229): add a Steps Using the Web Editor subheading plus screen
reader and sighted learning cards for the first web-editor challenge:
file navigation, the E and period shortcuts, finding the Commit changes
button, and a github.dev-is-VS-Code note linking Chapters 11 and 12.
- Appendix Z (#221): add GitHub's learning portal (learn.github.com) to
Additional Resources with an accessibility note.
- HUMAN_TEST_MATRIX, classroom README, GO-LIVE guide, E2E QA runbook:
status notes explaining that scripts/classroom/ was removed and that
the Student Progression Bot now seeds peer simulation artifacts
automatically; seeding steps rewritten as workflow dispatches.
- build-html.js: exclude gold.md (private maintainer log) from the public
site; validate-authoritative-sources.js: exclude it from content checks;
.gitignore it so it never lands in the public repo.
- html/ regenerated.
Closes#221, closes#229, closes#231.
Co-authored-by: GitHub Workshop Bot <workshop@example.com>
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: GO-LIVE-QA-GUIDE.md
+4-2Lines changed: 4 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,7 @@
1
1
# Git Going with GitHub Go-Live QA Guide
2
2
3
+
> **Status note (2026-07):** GitHub Classroom and the `scripts/classroom/` PowerShell tooling were removed; provisioning is now the hybrid pipeline in `.github/scripts/provisioning/`, and peer simulation seeding happens automatically via the Student Progression Bot in each learning room. Interpret `scripts/classroom/*.ps1` steps below as the Student Progression Bot workflow dispatch (inputs `start_challenge`, `assignee`).
4
+
3
5
Use this guide before a cohort is opened to learners. It is the release gate for curriculum content, GitHub Classroom deployment, Learning Room automation, accessibility, and human test coverage. Podcast and LLM-generation QA is tracked here as non-blocking unless a podcast release is explicitly in scope.
4
6
5
7
For end-to-end execution details, use [admin/LEARNING-ROOM-E2E-QA-RUNBOOK.md](admin/LEARNING-ROOM-E2E-QA-RUNBOOK.md) as the operator procedure. This guide is the release gate summary; the runbook is the required execution playbook.
@@ -241,8 +243,8 @@ Run these checks in disposable student repositories created by GitHub Classroom.
241
243
242
244
### Seeding Scripts
243
245
244
-
-[ ]`Seed-LearningRoomChallenge.ps1` creates the requested starting challenge.
245
-
-[ ]`Seed-PeerSimulation.ps1` creates the peer simulation issues, branch, file, and PR.
Copy file name to clipboardExpand all lines: admin/LEARNING-ROOM-E2E-QA-RUNBOOK.md
+2Lines changed: 2 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,7 @@
1
1
# Learning Room End-to-End QA Runbook (Registration to Student Completion)
2
2
3
+
> **Status note (2026-07):** GitHub Classroom and the `scripts/classroom/` PowerShell tooling were removed. Provisioning is the hybrid pipeline in `.github/scripts/provisioning/` (workflow `provision-learning-rooms.yml`), and peer simulation artifacts are seeded automatically by the Student Progression Bot in each learning room. Interpret `scripts/classroom/*.ps1` steps below as the Student Progression Bot workflow dispatch (inputs `start_challenge`, `assignee`); `Seed-PeerSimulation.ps1` steps need no action because the bot seeds and self-repairs those artifacts.
4
+
3
5
Use this runbook when you want one operational checklist that covers the full workflow:
Copy file name to clipboardExpand all lines: classroom/HUMAN_TEST_MATRIX.md
+11-10Lines changed: 11 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,23 +17,24 @@ Full collaboration test:
17
17
18
18
## Required Facilitator Setup
19
19
20
-
After the student repository exists, run:
20
+
The old `scripts/classroom/` PowerShell seeding scripts were removed with GitHub Classroom. Seeding now runs through the Student Progression Bot workflow inside the student repository.
For Day 2-only testing, set `start_challenge` to `10` instead.
28
+
29
+
Equivalent CLI:
30
+
31
+
```bash
32
+
gh workflow run student-progression.yml -R Community-Access/learning-room-smoke-a -f start_challenge=1 -f assignee=test-student-a
32
33
```
33
34
34
35
## What The Peer Simulation Creates
35
36
36
-
`Seed-PeerSimulation.ps1` creates realistic collaboration artifacts inside the student's private repo:
37
+
The progression bot seeds realistic collaboration artifacts inside the student's private repo automatically whenever it creates a challenge issue (and repairs them if any are missing):
37
38
38
39
-`Peer Simulation: Welcome Link Needs Context` issue
39
40
-`Peer Simulation: Review Request for Contribution Guidance` issue
Copy file name to clipboardExpand all lines: classroom/README.md
+3-5Lines changed: 3 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,7 @@
1
1
# Workshop Deployment Guide
2
2
3
+
> **Status note (2026-07):** GitHub Classroom and the `scripts/classroom/` PowerShell tooling described in this guide have been removed. Current cohorts use hybrid provisioning (`.github/scripts/provisioning/`, triggered by the `provision-learning-rooms.yml` workflow), and peer simulation artifacts are seeded automatically by the Student Progression Bot inside each learning room. Where this guide references a `scripts/classroom/*.ps1` script, use the Student Progression Bot's **Run workflow** dispatch (inputs `start_challenge` and `assignee`) instead. This guide is retained for the parts that are still accurate (challenge flow, bots, grading).
4
+
3
5
> Single, end-to-end guide for deploying a new Git Going with GitHub workshop cohort. Covers everything from creating the classroom through post-workshop teardown. This is the only deployment document you need.
4
6
5
7
> Before sharing invite links with students, complete the [Go-Live QA Guide](../GO-LIVE-QA-GUIDE.md). It is the final release gate for content, workflows, Classroom setup, podcasts, accessibility, and human test coverage.
@@ -265,11 +267,7 @@ For Day 2, use `-Challenge 10`.
265
267
266
268
### Seeding peer simulation
267
269
268
-
Because each GitHub Classroom repository is private, students cannot automatically see a classmate's issues or pull requests. To preserve realistic collaboration without exposing private student repos, seed peer-simulation artifacts into each student's repository:
Because each learning room repository is private, students cannot automatically see a classmate's issues or pull requests. To preserve realistic collaboration without exposing private student repos, peer-simulation artifacts are seeded into each student's repository automatically: the Student Progression Bot creates them the first time it opens a challenge issue, and repairs them on later runs if any are missing. No facilitator action is required.
273
271
274
272
This creates two peer-simulation issues and one peer-simulation pull request. Challenges that ask students to comment, react, review, compare, or practice peer collaboration can use those seeded artifacts. If facilitators intentionally provision real buddy access, students may use real buddy repositories instead.
|`docs/setup-guide.md`| Getting-started instructions | Broken links and incomplete steps |
77
77
78
-
**Steps using the web editor:**
78
+
#### Steps Using the Web Editor
79
+
80
+
This is your first challenge that uses GitHub's web editor, so take a moment with the learning cards below before you start.
81
+
82
+
**About the web editor:** GitHub offers two browser-based editors. The **file editor** (the pencil icon on any file) edits one file at a time and is what these steps use. The full **github.dev** editor (press `.` (period) from the repository's Code page) is a browser-based version of Visual Studio Code with the same commands, Command Palette, and screen reader mode as the desktop app. Either works for this challenge. If you use github.dev, see [Chapter 11: VS Code Interface](11-vscode-interface.md) and the [VS Code Accessibility Deep Dive](12-vscode-accessibility.md) for full navigation guidance.
-**Find your file:** On the repository's Code page, the file list is a table. Use your table reading commands to reach the file named in your issue, then press `Enter` to open it. Or press `T` to open "Go to file" and type the file name.
88
+
-**Open the editor:** With the file displayed, press `E` to open it directly in the file editor, or press `B` (NVDA/JAWS buttons quick key) to find the "Edit this file" button and press `Enter`. VoiceOver: use the Buttons rotor (`VO+U`) to find "Edit this file" and press `VO+Space`.
89
+
-**Alternative - github.dev:** With the file displayed (or from the Code page), press `.` (period) to open the whole repository in github.dev, a web version of VS Code. Enable screen reader mode when prompted.
90
+
-**Find the Commit changes button:** After editing, press `B` (or use the Buttons rotor) to find the button named "Commit changes..." - it sits above the editor. Activating it opens a dialog where the branch name field and "Propose changes" button live; the dialog receives focus automatically.
91
+
92
+
</details>
93
+
94
+
<details>
95
+
<summary>Sighted users</summary>
96
+
97
+
- Navigate to the file via the file list or the "Go to file" search.
98
+
- Select the **pencil icon** (Edit this file) at the top right of the file view.
99
+
- After editing, select the green **Commit changes** button above the editor to open the commit dialog.
100
+
101
+
</details>
79
102
80
103
1. In your Learning Room repository, navigate to the file specified in your issue. Use the file tree or the "Go to file" button (`T` keyboard shortcut).
81
104
2. Open the file and activate the **pencil icon** (Edit this file) button.
**Text description of the layout above:** VS Code has five major regions arranged in a grid. The **Menu Bar** spans the full width across the top. Below it, the **Activity Bar** runs vertically along the left edge (it contains icons for Explorer, Source Control, Search, Extensions, and more). The **Sidebar** appears to the right of the Activity Bar and shows content for the selected activity (file tree, search results, etc.). The **Editor Area** fills the large central region where your files open. Below the Editor Area, the **Panel** stretches across the bottom and contains the Terminal, Problems, Output, and Debug Console tabs. Finally, the **Status Bar** runs along the very bottom showing line number, column, language mode, Git branch, Copilot status, encoding, and notifications.
452
+
| Region | Where it sits | What it contains |
453
+
| --- | --- | --- |
454
+
| Menu Bar | Full width across the top | File, Edit, View, Go, Run, Terminal, Help menus |
455
+
| Activity Bar | Vertical strip along the left edge | Icons for Explorer, Source Control, Search, Extensions, Accounts |
456
+
| Sidebar | Right of the Activity Bar | Content for the selected activity (file tree, search results, etc.) |
457
+
| Editor Area | Large central region | Your open files |
458
+
| Panel | Below the Editor Area | Terminal, Problems, Output, Debug Console tabs |
459
+
| Status Bar | Very bottom, full width | Line, column, language, Git branch, Copilot status, encoding, notifications |
460
+
461
+
**How the regions fit together:** VS Code has five major regions arranged in a grid. The **Menu Bar** spans the full width across the top. Below it, the **Activity Bar** runs vertically along the left edge (it contains icons for Explorer, Source Control, Search, Extensions, and more). The **Sidebar** appears to the right of the Activity Bar and shows content for the selected activity (file tree, search results, etc.). The **Editor Area** fills the large central region where your files open. Below the Editor Area, the **Panel** stretches across the bottom and contains the Terminal, Problems, Output, and Debug Console tabs. Finally, the **Status Bar** runs along the very bottom showing line number, column, language mode, Git branch, Copilot status, encoding, and notifications.
Copy file name to clipboardExpand all lines: docs/appendix-z-github-skills.md
+1Lines changed: 1 addition & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -333,6 +333,7 @@ Path 6: Cloud and Migration
333
333
-[GitHub Skills homepage](https://skills.github.com/) - browse all courses with descriptions
334
334
-[GitHub Skills organization](https://github.com/skills) - view all course repositories directly
335
335
-[GitHub Skills Discussions](https://github.com/orgs/skills/discussions) - ask questions and share feedback with the GitHub Skills community
336
+
-[GitHub's learning portal](https://learn.github.com/) - GitHub's broader learning hub, including certification prep and links to Microsoft Learn modules. Accessibility varies by module, but it is a rich way to explore concepts hands-on and Microsoft Learn content is often quite accessible.
Copy file name to clipboardExpand all lines: html/GO-LIVE-QA-GUIDE.html
+5-2Lines changed: 5 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -235,6 +235,9 @@ <h2 class="onpage-title">On This Page</h2>
235
235
</ul>
236
236
</nav>
237
237
<divid="course-content"><h1id="git-going-with-github-go-live-qa-guide">Git Going with GitHub Go-Live QA Guide</h1>
238
+
<blockquote>
239
+
<p><strong>Status note (2026-07):</strong> GitHub Classroom and the <code>scripts/classroom/</code> PowerShell tooling were removed; provisioning is now the hybrid pipeline in <code>.github/scripts/provisioning/</code>, and peer simulation seeding happens automatically via the Student Progression Bot in each learning room. Interpret <code>scripts/classroom/*.ps1</code> steps below as the Student Progression Bot workflow dispatch (inputs <code>start_challenge</code>, <code>assignee</code>).</p>
240
+
</blockquote>
238
241
<p>Use this guide before a cohort is opened to learners. It is the release gate for curriculum content, GitHub Classroom deployment, Learning Room automation, accessibility, and human test coverage. Podcast and LLM-generation QA is tracked here as non-blocking unless a podcast release is explicitly in scope.</p>
239
242
<p>For end-to-end execution details, use <ahref="admin/LEARNING-ROOM-E2E-QA-RUNBOOK.html">admin/LEARNING-ROOM-E2E-QA-RUNBOOK.md</a> as the operator procedure. This guide is the release gate summary; the runbook is the required execution playbook.</p>
240
243
<p>The goal is simple: a facilitator should be able to create a classroom, seed test repositories, complete every challenge path, validate every generated artifact, and know exactly what remains before students arrive.</p>
<li><inputaria-label="The progression bot seeds the peer simulation issues, branch, file, and PR automatically alongside the challenge issue." disabled="" type="checkbox">The progression bot seeds the peer simulation issues, branch, file, and PR automatically alongside the challenge issue.</li>
494
497
<li><inputaria-label="" disabled="" type="checkbox"><code>Start-MergeConflictChallenge.ps1</code> creates a real conflict against the student branch.</li>
495
498
<li><inputaria-label="" disabled="" type="checkbox"><code>Test-LearningRoomTemplate.ps1</code> reports the template readiness state.</li>
496
499
<li><inputaria-label="Script failures show a clear error message and do not partially hide the problem." disabled="" type="checkbox"> Script failures show a clear error message and do not partially hide the problem.</li>
Copy file name to clipboardExpand all lines: html/admin/LEARNING-ROOM-E2E-QA-RUNBOOK.html
+3Lines changed: 3 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -269,6 +269,9 @@ <h2 class="onpage-title">On This Page</h2>
269
269
</ul>
270
270
</nav>
271
271
<divid="course-content"><h1id="learning-room-end-to-end-qa-runbook-registration-to-student-completion">Learning Room End-to-End QA Runbook (Registration to Student Completion)</h1>
272
+
<blockquote>
273
+
<p><strong>Status note (2026-07):</strong> GitHub Classroom and the <code>scripts/classroom/</code> PowerShell tooling were removed. Provisioning is the hybrid pipeline in <code>.github/scripts/provisioning/</code> (workflow <code>provision-learning-rooms.yml</code>), and peer simulation artifacts are seeded automatically by the Student Progression Bot in each learning room. Interpret <code>scripts/classroom/*.ps1</code> steps below as the Student Progression Bot workflow dispatch (inputs <code>start_challenge</code>, <code>assignee</code>); <code>Seed-PeerSimulation.ps1</code> steps need no action because the bot seeds and self-repairs those artifacts.</p>
274
+
</blockquote>
272
275
<p>Use this runbook when you want one operational checklist that covers the full workflow:</p>
0 commit comments