Skip to content

Commit 064d9f2

Browse files
committed
fix: curriculum sequencing audit - 10 issues resolved
- Move Step 1.5 (Git identity) after Step 6 (Install Git) in pre-workshop setup - Eliminate dual section/step numbering in pre-workshop setup TOC and headings - Add merge conflicts mini-lesson to Day 1 Block 5 before contribution sprint - Add fork-and-clone instructions to Day 2 Block 1 (was assumed but never taught) - Fix duplicate Part 6B labels in Day 1 Block 6 (now 6A through 6F) - Fix insiders-a11y-tracker prerequisite (Issue Templates is Day 2, not Day 1) - Add 15-minute Copilot orientation to start of Day 2 Block 2 - Standardize agent count to six across DAY1_AGENDA and DAY2_AGENDA - Add note mapping Chapters 14-15 to Day 2 agenda blocks in course guide - Fix Day 2 intro merge conflict claim (replaced with accurate Day 1 summary) - Update external anchor references in chapters 04, 05, and appendix B - Rebuild all HTML output
1 parent fd69cb2 commit 064d9f2

20 files changed

+1026
-433
lines changed

DAY1_AGENDA.md

Lines changed: 196 additions & 68 deletions
Large diffs are not rendered by default.

DAY2_AGENDA.md

Lines changed: 44 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# Day 2 Agenda
22
## From Contributor to Product Maker - Igniting the Forge
33

4-
> **The premise of Day 2:** You spent Day 1 learning how GitHub works - by hand, in the browser, with your screen reader. You filed real issues. You opened a real pull request. You resolved a real merge conflict. Those skills are yours now.
4+
> **The premise of Day 2:** You spent Day 1 learning how GitHub works - by hand, in the browser, with your screen reader. You filed real issues. You opened a real pull request. You reviewed someone else's work. Those skills are yours now.
55
>
66
> Day 2 is about what you can build with those skills. You will deepen your contributions using VS Code and GitHub Copilot. You will use Accessibility Agents - a live, public accessibility project built by your facilitator - not as a shortcut around the skills you learned, but as a **product you can understand, evaluate, critique, and improve** because you now know exactly what it is doing and why.
77
>
@@ -83,18 +83,35 @@ VS Code has a dedicated screen reader accessibility mode that adjusts verbosity,
8383

8484
**Key setting to check:** Open Settings (`Ctrl+,`) → search `accessibility support` → confirm it shows `on`.
8585

86-
### Step 2 - Open Accessibility Agents as a Workspace
87-
1. Open a terminal (`Ctrl+Backtick`)
88-
2. Navigate to wherever you cloned your fork: `cd path/to/accessibility-agents`
89-
3. Open VS Code in that folder: `code .`
90-
4. VS Code opens with the `accessibility-agents` repository as your workspace
86+
### Step 2 - Fork, Clone, and Open Accessibility Agents
87+
88+
Before you can work on Accessibility Agents locally, you need your own copy (a fork) and a local clone of that fork.
89+
90+
**Fork the repository (browser - a Day 1 skill):**
91+
1. Navigate to [github.com/community-access/accessibility-agents](https://github.com/community-access/accessibility-agents)
92+
2. Find and activate the **Fork** button (`B` to navigate buttons)
93+
3. Keep the defaults and activate **Create fork**
94+
4. GitHub redirects you to your fork: `github.com/[your-username]/accessibility-agents`
95+
96+
**Clone the fork (VS Code terminal - your first Git command):**
97+
1. Open a terminal in VS Code (`Ctrl+Backtick`)
98+
2. Navigate to where you want to store projects: `cd ~/Documents` (or your preferred folder)
99+
3. Clone your fork:
100+
```bash
101+
git clone https://github.com/[your-username]/accessibility-agents.git
102+
```
103+
4. Enter the project folder: `cd accessibility-agents`
104+
5. Open VS Code in that folder: `code .`
105+
6. VS Code opens with the `accessibility-agents` repository as your workspace
106+
107+
> **Screen reader note:** The `git clone` command prints progress messages. When you hear the terminal go quiet, it is done. The folder now exists on your machine.
91108
92109
**What to navigate first (with screen reader):**
93110

94111
| VS Code Area | Key | What You Hear |
95112
|-------------|-----|---------------|
96113
| Explorer sidebar | `Ctrl+Shift+E` | File and folder tree |
97-
| `.github/agents/` folder | `Arrow keys` | Five `.agent.md` files |
114+
| `.github/agents/` folder | `Arrow keys` | Six `.agent.md` files |
98115
| `.github/prompts/` folder | `Arrow keys` | 28 slash command template files |
99116
| `Documentation/` folder | `Arrow keys` | `GETTING-STARTED.md`, `GUIDE.md` |
100117
| `ai-instructions/` folder | `Arrow keys` | Copilot, Claude, OpenAI integration guides |
@@ -124,6 +141,25 @@ Press `Ctrl+Shift+I` to open the Chat panel.
124141
## Block 2 - Deep Contribution with Copilot
125142
**10:45-12:00**
126143

144+
### Copilot Orientation (15 min)
145+
146+
Before diving into contributions, get familiar with how Copilot works as a writing partner.
147+
148+
**Inline suggestions (`Ctrl+I`):**
149+
1. Open any `.md` file in the workspace
150+
2. Place your cursor at the end of a line and press `Ctrl+I`
151+
3. Type a prompt: `Add a sentence explaining why this agent uses heading navigation`
152+
4. Copilot suggests text inline. Press `Tab` to accept, `Escape` to dismiss
153+
5. **Screen reader note:** NVDA announces "Inline suggestion" when one appears. Press `Alt+]` to read the suggestion before accepting
154+
155+
**Chat as a thinking partner:**
156+
1. Open Chat (`Ctrl+Shift+I`) if not already open
157+
2. Type: `Explain what the daily-briefing agent does in plain English`
158+
3. Read the response. Use `H` (heading navigation) to jump between sections
159+
4. Try: `What are three ways I could improve this agent for screen reader users?`
160+
161+
**Key principle:** Copilot drafts. You decide. Every suggestion should be read, evaluated, and edited before committing. Your name goes on the commit.
162+
127163
### Purpose
128164
Make a richer contribution to your fork of `accessibility-agents` using Copilot as a writing partner - not a replacement for your judgment. Copilot helps you articulate ideas you already have. The idea - the product intention - is yours.
129165

@@ -182,7 +218,7 @@ Agents are run in a specific sequence - from broadest to most specific, from obs
182218
| 1 | `@daily-briefing` | Reading your notification inbox and activity summary | [Navigating Repos](docs/02-navigating-repositories.md) + [Notifications](docs/09-notifications.md) |
183219
| 2 | `@issue-tracker` | Triaging and prioritizing issues manually | [Working with Issues](docs/04-working-with-issues.md) + [Labels & Milestones](docs/08-labels-milestones-projects.md) |
184220
| 3 | `@pr-review` | Manually reviewing a PR diff and writing inline comments | [Working with Pull Requests](docs/05-working-with-pull-requests.md) |
185-
| 4 | `@insiders-a11y-tracker` | Filing accessibility bugs and applying WCAG labels | [Working with Issues](docs/04-working-with-issues.md) + [Issue Templates](docs/15-issue-templates.md) |
221+
| 4 | `@insiders-a11y-tracker` | Filing accessibility bugs and applying WCAG labels | [Working with Issues](docs/04-working-with-issues.md) + [Labels & Milestones](docs/08-labels-milestones-projects.md) |
186222

187223
`@analytics` is available as an extension if Block 3 runs ahead of schedule - it requires understanding contribution graphs and activity history.
188224

docs/00-pre-workshop-setup.md

Lines changed: 74 additions & 84 deletions
Original file line numberDiff line numberDiff line change
@@ -9,22 +9,22 @@
99

1010
## Table of Contents
1111

12-
1. [What You Will Need](#1-what-you-will-need)
13-
2. [Step 1 - Create Your GitHub Account](#2-step-1--create-your-github-account)
14-
3. [Step 1.5 - Configure Git Identity (If Using Git Locally)](#3-step-15--configure-git-identity-if-using-git-locally)
15-
4. [Step 2 - Configure GitHub Accessibility Settings](#4-step-2--configure-github-accessibility-settings)
16-
5. [Step 3 - Configure Your Profile](#5-step-3--configure-your-profile)
17-
6. [Step 4 - Verify Modern GitHub Interface](#6-step-4--verify-modern-github-interface)
18-
7. [Step 5 - Test Your Screen Reader on GitHub](#7-step-5--test-your-screen-reader-on-github)
19-
8. [Step 6 - Install Git and Visual Studio Code](#8-step-6--install-git-and-visual-studio-code-day-2)
20-
9. [Step 7 - Install GitHub Copilot in VS Code](#9-step-7--install-github-copilot-in-vs-code-day-2)
21-
10. [Step 8 - Verification Checklist](#10-step-8--verification-checklist)
22-
11. [Other GitHub Access Methods (Reference Only)](#11-other-github-access-methods-reference-only)
23-
12. [Getting Help Before the Event](#12-getting-help-before-the-event)
12+
1. [What You Will Need](#what-you-will-need)
13+
2. [Step 1 - Create Your GitHub Account](#step-1-create-your-github-account)
14+
3. [Step 2 - Configure GitHub Accessibility Settings](#step-2-configure-github-accessibility-settings)
15+
4. [Step 3 - Configure Your Profile](#step-3-configure-your-profile)
16+
5. [Step 4 - Check GitHub Feature Preview Settings](#step-4-check-github-feature-preview-settings)
17+
6. [Step 5 - Set Up Your Screen Reader and Browser](#step-5-set-up-your-screen-reader-browser)
18+
7. [Step 6 - Install Git and Visual Studio Code](#step-6-install-git-and-visual-studio-code)
19+
8. [Step 7 - Configure Git Identity](#step-7-configure-git-identity)
20+
9. [Step 8 - Install VS Code Extensions](#step-8-install-vs-code-extensions)
21+
10. [Step 9 - Verification Checklist](#step-9-verification-checklist)
22+
11. [Other GitHub Access Methods (Reference Only)](#other-github-access-methods-reference-only)
23+
12. [Getting Help Before the Event](#getting-help-before-the-event)
2424

2525
---
2626

27-
## 1. What You Will Need
27+
## What You Will Need
2828

2929
### Hardware
3030
- A computer running Windows or macOS
@@ -59,9 +59,9 @@ You only need **one** of these. Use whichever you are most comfortable with.
5959
6060
---
6161

62-
## 2. Step 1 - Create Your GitHub Account
62+
## Step 1 - Create Your GitHub Account
6363

64-
If you already have a GitHub account, skip to [Step 2](#4-step-2--configure-github-accessibility-settings).
64+
If you already have a GitHub account, skip to [Step 2](#step-2-configure-github-accessibility-settings).
6565

6666
> **Before you begin:** Have your email address and a chosen password ready. The signup form is a single-page form with several fields - your screen reader will encounter a verification puzzle partway through (see note below).
6767
@@ -182,66 +182,7 @@ Copy-ready paragraph for `CONTRIBUTING.md` / registration forms
182182

183183
---
184184

185-
## 3. Step 1.5 - Configure Git Identity (If Using Git Locally)
186-
187-
> **Important:** Complete this step after installing Git (Step 6) and before the workshop begins. Git must know who you are before you can make your first commit.
188-
189-
Git needs to know who you are so every commit you make is attributed to you. This affects how your name appears in project history.
190-
191-
### Configure in VS Code (Recommended for This Workshop)
192-
193-
1. Open **Visual Studio Code**
194-
2. Open the integrated terminal:
195-
- Menu: **Terminal → New Terminal**
196-
- Keyboard: `` Ctrl+` `` (Windows) or `` Cmd+` `` (Mac)
197-
3. Type the following commands, replacing with your information:
198-
199-
```bash
200-
git config --global user.name "Your Name"
201-
git config --global user.email "your-email@example.com"
202-
```
203-
204-
**What to use:**
205-
- **user.name:** Your real name or the name you want shown on commits (e.g., "Jane Smith")
206-
- **user.email:** The email address associated with your GitHub account (must match exactly)
207-
208-
**Screen reader note:** The terminal in VS Code is accessible with all major screen readers. Press `` Ctrl+` `` to move focus to the terminal, type your commands, and press `Enter`.
209-
210-
### Why This Matters
211-
212-
Every commit you make includes:
213-
- Your name
214-
- Your email address
215-
- A timestamp
216-
- The commit message
217-
218-
If Git isn't configured, it will either:
219-
- Use a default name like "Unknown" (looks unprofessional in project history)
220-
- Refuse to create commits with an error message
221-
222-
### Verify Your Configuration
223-
224-
Run this command to see your current settings:
225-
226-
```bash
227-
git config --global --list
228-
```
229-
230-
You should see:
231-
```
232-
user.name=Your Name
233-
user.email=your-email@example.com
234-
```
235-
236-
### Using the Correct Email
237-
238-
Use the same email you registered with GitHub. If you're concerned about privacy, GitHub offers a no-reply email you can use: `username@users.noreply.github.com` - find it in [Settings → Emails](https://github.com/settings/emails).
239-
240-
**When to configure this:** Before your first commit in VS Code. You can skip it on Day 1 if you're only working through the GitHub web interface.
241-
242-
---
243-
244-
## 4. Step 2 - Configure GitHub Accessibility Settings
185+
## Step 2 - Configure GitHub Accessibility Settings
245186

246187
These settings make GitHub significantly more usable with a screen reader. **Do not skip this section** - one setting in particular (hovercards) adds significant noise to every page if left on.
247188

@@ -347,7 +288,7 @@ Theme is on a separate page: [GitHub Appearance Settings](https://github.com/set
347288
348289
---
349290
350-
## 5. Step 3 - Configure Your Profile
291+
## Step 3 - Configure Your Profile
351292
352293
Your GitHub profile is your public identity in the open source community. Setting it up properly helps maintainers know who you are.
353294
@@ -372,7 +313,7 @@ A profile picture humanizes your contributions. It can be a photo or any image.
372313
373314
---
374315
375-
## 6. Step 4 - Check GitHub Feature Preview Settings
316+
## Step 4 - Check GitHub Feature Preview Settings
376317
377318
GitHub continuously rolls out improvements to its interface. Some enhancements start as opt-in Feature Previews before becoming the standard experience. Two features matter most for screen reader users working through this workshop:
378319
@@ -450,7 +391,7 @@ If you open Feature Preview and neither **"New Issues Experience"** nor **"New F
450391
451392
---
452393
453-
## 7. Step 5 - Set Up Your Screen Reader & Browser
394+
## Step 5 - Set Up Your Screen Reader & Browser
454395
455396
### NVDA (Windows)
456397
@@ -522,7 +463,7 @@ If you open Feature Preview and neither **"New Issues Experience"** nor **"New F
522463
523464
---
524465
525-
## 8. Step 6 - Install Git and Visual Studio Code
466+
## Step 6 - Install Git and Visual Studio Code
526467
527468
### Install Git First
528469
@@ -550,7 +491,7 @@ Git is often already present via Xcode Command Line Tools. To check:
550491
- PowerShell is accessible with all screen readers via Browse Mode or Forms Mode
551492
- Type `git --version`, press `Enter`, then press `↑` to re-read the output line
552493
553-
Once Git is installed, proceed to [Step 1.5](#3-step-15--configure-git-identity-if-using-git-locally) to configure your name and email before your first commit.
494+
Once Git is installed, you will configure your Git identity in Step 7 after VS Code is set up.
554495
555496
---
556497
@@ -612,7 +553,56 @@ If VS Code did **not** prompt you automatically, enable it manually:
612553
613554
---
614555
615-
## 9. Step 7 - Install VS Code Extensions
556+
## Step 7 - Configure Git Identity
557+
558+
Now that Git is installed, tell it who you are. Git embeds your name and email in every commit you make, and this affects how your contributions appear in project history.
559+
560+
### Configure in VS Code
561+
562+
1. Open **Visual Studio Code**
563+
2. Open the integrated terminal:
564+
- Menu: **Terminal → New Terminal**
565+
- Keyboard: `` Ctrl+` `` (Windows) or `` Cmd+` `` (Mac)
566+
3. Type the following commands, replacing with your information:
567+
568+
```bash
569+
git config --global user.name "Your Name"
570+
git config --global user.email "your-email@example.com"
571+
```
572+
573+
**What to use:**
574+
- **user.name:** Your real name or the name you want shown on commits (e.g., "Jane Smith")
575+
- **user.email:** The email address associated with your GitHub account (must match exactly)
576+
577+
**Screen reader note:** The terminal in VS Code is accessible with all major screen readers. Press `` Ctrl+` `` to move focus to the terminal, type your commands, and press `Enter`.
578+
579+
### Why This Matters
580+
581+
If Git isn't configured, it will either:
582+
- Use a default name like "Unknown" (looks unprofessional in project history)
583+
- Refuse to create commits with an error message
584+
585+
### Verify Your Configuration
586+
587+
Run this command to see your current settings:
588+
589+
```bash
590+
git config --global --list
591+
```
592+
593+
You should see:
594+
```
595+
user.name=Your Name
596+
user.email=your-email@example.com
597+
```
598+
599+
### Using the Correct Email
600+
601+
Use the same email you registered with GitHub. If you're concerned about privacy, GitHub offers a no-reply email you can use: `username@users.noreply.github.com` - find it in [Settings → Emails](https://github.com/settings/emails).
602+
603+
---
604+
605+
## Step 8 - Install VS Code Extensions
616606
617607
This workshop uses two VS Code extensions. Both are published by GitHub and are free. Install them in the order shown below.
618608
@@ -703,7 +693,7 @@ For this workshop, Free tier is sufficient. If you want unlimited access, paid p
703693
704694
---
705695
706-
## 10. Step 8 - Verification Checklist
696+
## Step 9 - Verification Checklist
707697
708698
Work through this checklist before Day 1. Check off each item:
709699
@@ -742,7 +732,7 @@ GIT & VS CODE (required before the workshop)
742732
743733
---
744734
745-
## 11. Other GitHub Access Methods (Reference Only)
735+
## Other GitHub Access Methods (Reference Only)
746736
747737
This workshop focuses entirely on GitHub.com in the browser and VS Code. However, you should be aware that other ways to work with GitHub exist. We list them here for your reference - we will not be teaching these in depth.
748738
@@ -799,7 +789,7 @@ We are not covering Git commands in this workshop. If you want to learn Git, the
799789
800790
---
801791
802-
## 12. Getting Help Before the Event
792+
## Getting Help Before the Event
803793
804794
If you cannot complete any step in this guide before the workshop:
805795

0 commit comments

Comments
 (0)