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
- 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
Copy file name to clipboardExpand all lines: DAY2_AGENDA.md
+44-8Lines changed: 44 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
# Day 2 Agenda
2
2
## From Contributor to Product Maker - Igniting the Forge
3
3
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.
5
5
>
6
6
> 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.
7
7
>
@@ -83,18 +83,35 @@ VS Code has a dedicated screen reader accessibility mode that adjusts verbosity,
83
83
84
84
**Key setting to check:** Open Settings (`Ctrl+,`) → search `accessibility support` → confirm it shows `on`.
85
85
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)
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.
91
108
92
109
**What to navigate first (with screen reader):**
93
110
94
111
| VS Code Area | Key | What You Hear |
95
112
|-------------|-----|---------------|
96
113
| Explorer sidebar |`Ctrl+Shift+E`| File and folder tree |
@@ -124,6 +141,25 @@ Press `Ctrl+Shift+I` to open the Chat panel.
124
141
## Block 2 - Deep Contribution with Copilot
125
142
**10:45-12:00**
126
143
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
+
127
163
### Purpose
128
164
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.
129
165
@@ -182,7 +218,7 @@ Agents are run in a specific sequence - from broadest to most specific, from obs
182
218
| 1 |`@daily-briefing`| Reading your notification inbox and activity summary |[Navigating Repos](docs/02-navigating-repositories.md) + [Notifications](docs/09-notifications.md)|
183
219
| 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)|
184
220
| 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)|
186
222
187
223
`@analytics` is available as an extension if Block 3 runs ahead of schedule - it requires understanding contribution graphs and activity history.
12.[Getting Help Before the Event](#getting-help-before-the-event)
24
24
25
25
---
26
26
27
-
## 1. What You Will Need
27
+
## What You Will Need
28
28
29
29
### Hardware
30
30
- A computer running Windows or macOS
@@ -59,9 +59,9 @@ You only need **one** of these. Use whichever you are most comfortable with.
59
59
60
60
---
61
61
62
-
## 2. Step 1 - Create Your GitHub Account
62
+
## Step 1 - Create Your GitHub Account
63
63
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).
65
65
66
66
> **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).
67
67
@@ -182,66 +182,7 @@ Copy-ready paragraph for `CONTRIBUTING.md` / registration forms
>**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:
- **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.
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.
247
188
@@ -347,7 +288,7 @@ Theme is on a separate page: [GitHub Appearance Settings](https://github.com/set
347
288
348
289
---
349
290
350
-
## 5. Step 3 - Configure Your Profile
291
+
## Step 3 - Configure Your Profile
351
292
352
293
Your GitHub profile is your public identity in the open source community. Setting it up properly helps maintainers know who you are.
353
294
@@ -372,7 +313,7 @@ A profile picture humanizes your contributions. It can be a photo or any image.
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:
378
319
@@ -450,7 +391,7 @@ If you open Feature Preview and neither **"New Issues Experience"** nor **"New F
450
391
451
392
---
452
393
453
-
## 7. Step 5 - Set Up Your Screen Reader & Browser
394
+
## Step 5 - Set Up Your Screen Reader & Browser
454
395
455
396
### NVDA (Windows)
456
397
@@ -522,7 +463,7 @@ If you open Feature Preview and neither **"New Issues Experience"** nor **"New F
522
463
523
464
---
524
465
525
-
## 8. Step 6 - Install Git and Visual Studio Code
466
+
## Step 6 - Install Git and Visual Studio Code
526
467
527
468
### Install Git First
528
469
@@ -550,7 +491,7 @@ Git is often already present via Xcode Command Line Tools. To check:
550
491
- PowerShell is accessible with all screen readers via Browse Mode or Forms Mode
551
492
- Type `git --version`, press `Enter`, then press `↑` to re-read the output line
552
493
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.
554
495
555
496
---
556
497
@@ -612,7 +553,56 @@ If VS Code did **not** prompt you automatically, enable it manually:
612
553
613
554
---
614
555
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.
- **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
616
606
617
607
This workshop uses two VS Code extensions. Both are published by GitHub and are free. Install them in the order shown below.
618
608
@@ -703,7 +693,7 @@ For this workshop, Free tier is sufficient. If you want unlimited access, paid p
703
693
704
694
---
705
695
706
-
## 10. Step 8 - Verification Checklist
696
+
## Step 9 - Verification Checklist
707
697
708
698
Work through this checklist before Day 1. Check off each item:
709
699
@@ -742,7 +732,7 @@ GIT & VS CODE (required before the workshop)
742
732
743
733
---
744
734
745
-
## 11. Other GitHub Access Methods (Reference Only)
735
+
## Other GitHub Access Methods (Reference Only)
746
736
747
737
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.
748
738
@@ -799,7 +789,7 @@ We are not covering Git commands in this workshop. If you want to learn Git, the
799
789
800
790
---
801
791
802
-
## 12. Getting Help Before the Event
792
+
## Getting Help Before the Event
803
793
804
794
If you cannot complete any step in this guide before the workshop:
0 commit comments