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
Copy file name to clipboardExpand all lines: docs/02-navigating-repositories.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -640,7 +640,7 @@ Navigate to the [Accessibility Agents repository](https://github.com/community-a
640
640
641
641
> ### Day 2 Amplifier - Accessibility Agents: `@daily-briefing`
642
642
>
643
-
> **Navigate every folder of `accessibility-agents` manually today before using any agent.** Find `.github/agents/`, open a `.agent.md` file, and read it - that file is how an agent knows what to do. You must understand the structure before you can evaluate whether an agent understood it correctly.
643
+
> **Navigate every folder of [accessibility-agents](https://github.com/Community-Access/accessibility-agents) manually today before using any agent.** Find `.github/agents/`, open a `.agent.md` file, and read it - that file is how an agent knows what to do. You must understand the structure before you can evaluate whether an agent understood it correctly.
644
644
>
645
645
> Once you have mastered manual repository navigation:
Copy file name to clipboardExpand all lines: docs/04-working-with-issues.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -44,9 +44,9 @@ Chapter 4 is the first **issue-based challenge chapter** with short, confidence-
44
44
45
45
**Goal:** File a new issue in the Learning Room repository with a specific title and a meaningful description.
46
46
47
-
**Where you are working:** the Issues tab of the `learning-room` repository on GitHub.com.
47
+
**Where you are working:** the Issues tab of the [learning-room](https://github.com/Community-Access/learning-room) repository on GitHub.com.
48
48
49
-
1. Open the `learning-room` repository in your browser.
49
+
1. Open the [learning-room](https://github.com/Community-Access/learning-room) repository in your browser.
50
50
2. Navigate to the **Issues** tab (press `G` then `I` to jump there with keyboard shortcuts, or find the "Issues" link in the repository navigation).
51
51
3. Activate the **New issue** button.
52
52
4. If a template picker appears, select **Open a blank issue** (or choose a template if one fits).
@@ -67,9 +67,9 @@ Chapter 4 is the first **issue-based challenge chapter** with short, confidence-
67
67
68
68
**Goal:** Leave a comment on another student's issue and use an @mention to notify them.
69
69
70
-
**Where you are working:** the Issues tab of the `learning-room` repository on GitHub.com.
70
+
**Where you are working:** the Issues tab of the [learning-room](https://github.com/Community-Access/learning-room) repository on GitHub.com.
71
71
72
-
1. Open the **Issues** tab in the `learning-room` repository.
72
+
1. Open the **Issues** tab in the [learning-room](https://github.com/Community-Access/learning-room) repository.
73
73
2. Find an issue created by a classmate (look for issues from Challenge 4.1, or browse recent open issues).
74
74
3. Open the issue by activating its title link.
75
75
4. Read the issue description to understand what they reported.
@@ -204,7 +204,7 @@ An issue is a discussion thread attached to a repository. Issues are used for:
204
204
205
205
Every issue has a **number** (`#42`), a **state** (Open or Closed), a **title**, a **description**, and a **comment thread**. Issues are public by default on public repositories.
206
206
207
-
> **Learning Room connection:** In the `learning-room` repo, every challenge from `docs/CHALLENGES.md` becomes an issue. For example, Challenge 1 ("Fix Broken Link") is filed as an issue pointing to `docs/welcome.md`, describing the broken link and linking to the challenge success criteria. When you open a PR to fix it, you reference the issue with `Closes #XX` to automatically close it on merge.
207
+
> **Learning Room connection:** In the [learning-room](https://github.com/Community-Access/learning-room) repo, every challenge from `docs/CHALLENGES.md` becomes an issue. For example, Challenge 1 ("Fix Broken Link") is filed as an issue pointing to `docs/welcome.md`, describing the broken link and linking to the challenge success criteria. When you open a PR to fix it, you reference the issue with `Closes #XX` to automatically close it on merge.
208
208
209
209
210
210
## Navigating to the Issues List
@@ -1060,7 +1060,7 @@ Go to the Learning Room repository and file a real issue:
1060
1060
> Once you have mastered manual issue management:
1061
1061
>
1062
1062
> -**In VS Code** - `@issue-tracker find open issues labeled good-first-issue` searches cross-repository with community sentiment scoring, release-awareness prioritization, and batch-reply capability across every repo you have access to
1063
-
> -**In your repo** - The issue templates in `accessibility-agents/.github/ISSUE_TEMPLATE/` structure both human filing and automated triage; fork `accessibility-agents` and that structure travels into any project you lead
1063
+
> -**In your repo** - The issue templates in `accessibility-agents/.github/ISSUE_TEMPLATE/` structure both human filing and automated triage; fork [accessibility-agents](https://github.com/Community-Access/accessibility-agents) and that structure travels into any project you lead
1064
1064
> -**In the cloud** - GitHub Agentic Workflows triage new issues the moment they are opened: applying labels, posting first-response comments, adding to Project boards - the same triage actions you practiced manually today, running at scale
1065
1065
>
1066
1066
> *Today you are the triage engine. On Day 2, you understand the engine well enough to direct it.*
Copy file name to clipboardExpand all lines: docs/05-vscode-accessibility.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -32,7 +32,7 @@ For this workshop, Chapter 5 is a **guided setup chapter** with a lightweight co
32
32
33
33
**Estimated time:** 10-15 minutes.
34
34
35
-
1. Open the `learning-room` repository on GitHub.com.
35
+
1. Open the [learning-room](https://github.com/Community-Access/learning-room) repository on GitHub.com.
36
36
2. Press `.` (the period key) on your keyboard. This launches **github.dev** - a full VS Code editor running in your browser. Wait a few seconds for it to load.
37
37
3. Enable screen reader mode:
38
38
-**Windows (NVDA/JAWS):** Press `Shift+Alt+F1`. You should hear an announcement confirming screen reader mode is on.
@@ -136,7 +136,7 @@ GitHub's browser interface is excellent for reviewing, discussing, and triaging.
136
136
| Run Accessibility Agents | Not available | Copilot Chat with agent files |
137
137
| See errors in your contribution | After push | Real-time as you type |
138
138
139
-
For Markdown contributions (which is most of what `accessibility-agents` needs), VS Code gives you Copilot assistance, live preview, and the same Git workflow - with less tab switching and with agents available on every file you open.
139
+
For Markdown contributions (which is most of what [accessibility-agents](https://github.com/Community-Access/accessibility-agents) needs), VS Code gives you Copilot assistance, live preview, and the same Git workflow - with less tab switching and with agents available on every file you open.
Copy file name to clipboardExpand all lines: docs/06-working-with-pull-requests.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -47,7 +47,7 @@ Chapter 6 is the first **PR-validated chapter** where students convert issue wor
47
47
48
48
**Goal:** Edit one of the practice files and save your change on a new branch.
49
49
50
-
**Where you are working:** the `learning-room` repository on GitHub.com, using the web editor.
50
+
**Where you are working:** the [learning-room](https://github.com/Community-Access/learning-room) repository on GitHub.com, using the web editor.
51
51
52
52
**Before you start:** Open your **assigned Chapter 6.1 challenge issue** (the one titled "Chapter 6.1: Create One Small Branch Change (@yourname)"). The issue description tells you which file to edit and what to fix.
53
53
@@ -63,7 +63,7 @@ The following table summarizes the practice files in the learning-room, what eac
63
63
64
64
**Steps using the web editor:**
65
65
66
-
1. In the `learning-room` repository, navigate to the file specified in your issue. Use the file tree or the "Go to file" button (`T` keyboard shortcut).
66
+
1. In the [learning-room](https://github.com/Community-Access/learning-room) repository, navigate to the file specified in your issue. Use the file tree or the "Go to file" button (`T` keyboard shortcut).
67
67
2. Open the file and activate the **pencil icon** (Edit this file) button.
68
68
- Screen reader users (NVDA/JAWS): Press `B` to navigate buttons, find "Edit this file," and press `Enter`.
69
69
- VoiceOver users: Press `VO+U`, open Buttons rotor, find "Edit this file," and press `VO+Space`.
@@ -1240,7 +1240,7 @@ Go to the Learning Room repository's Pull Requests tab and find any open or rece
1240
1240
> Once you have mastered manual pull request review:
1241
1241
>
1242
1242
> -**In VS Code** - `@pr-review review PR #N` generates line-numbered diffs with change maps, risk assessment, before/after snapshots, CI results, and suggested inline comments - a documented starting point for your own review, not a replacement for it
1243
-
> -**In your repo** - Accessibility Agents' review capabilities work across every repository you have access to by default; fork `accessibility-agents` and those capabilities travel with your project from day one
1243
+
> -**In your repo** - Accessibility Agents' review capabilities work across every repository you have access to by default; fork [accessibility-agents](https://github.com/Community-Access/accessibility-agents) and those capabilities travel with your project from day one
1244
1244
> -**In the cloud** - GitHub Agentic Workflows can auto-generate PR descriptions, verify linked issues, and post accessibility impact summaries on a `pull_request` trigger - running the moment a PR is opened, whether or not anyone is watching
1245
1245
>
1246
1246
> *The agent documents the diff. You bring the context that no diff can contain.*
Copy file name to clipboardExpand all lines: docs/07-merge-conflicts.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -26,7 +26,7 @@ Chapter 7 uses **one controlled practice challenge** so students can learn confl
26
26
27
27
**Goal:** Identify the three types of conflict markers in a practice file, decide which content to keep, remove the markers, and submit a clean PR.
28
28
29
-
**Where you are working:** the `learning-room` repository on GitHub.com (web editor) or in VS Code if you cloned locally.
29
+
**Where you are working:** the [learning-room](https://github.com/Community-Access/learning-room) repository on GitHub.com (web editor) or in VS Code if you cloned locally.
30
30
31
31
**Before you start:** Open your **assigned Chapter 7 challenge issue** (the one titled "Chapter 7.1: Resolve Conflict Markers (@yourname)"). The issue description tells you which practice file contains the conflict markers.
Copy file name to clipboardExpand all lines: docs/08-culture-etiquette.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,7 +24,7 @@ Chapter 8 is a **communication and culture chapter**.
24
24
25
25
**Goal:** Identify three concrete communication behaviors you will practice during the rest of the workshop.
26
26
27
-
**Where you are working:** your assigned Chapter 8 challenge issue in the `learning-room` repository on GitHub.com.
27
+
**Where you are working:** your assigned Chapter 8 challenge issue in the [learning-room](https://github.com/Community-Access/learning-room) repository on GitHub.com.
28
28
29
29
1. Read through the chapter content below, paying attention to the sections on GitHub Flow, constructive feedback, and asking for help.
30
30
2. As you read, think about one situation from Day 1 where communication helped (or could have helped) you.
Copy file name to clipboardExpand all lines: docs/09-labels-milestones-projects.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,9 +24,9 @@ Chapter 9 is a **guided triage chapter** focused on organization skills.
24
24
25
25
**Goal:** Read the details of a Learning Room issue and post a structured triage recommendation that a maintainer could act on immediately.
26
26
27
-
**Where you are working:** your assigned Chapter 9 challenge issue in the `learning-room` repository on GitHub.com, plus one other open issue you will triage.
27
+
**Where you are working:** your assigned Chapter 9 challenge issue in the [learning-room](https://github.com/Community-Access/learning-room) repository on GitHub.com, plus one other open issue you will triage.
28
28
29
-
1. Open the **Issues** tab in the `learning-room` repository.
29
+
1. Open the **Issues** tab in the [learning-room](https://github.com/Community-Access/learning-room) repository.
30
30
2. Find any **open issue** that does not already have labels applied (or pick one your facilitator assigns).
31
31
3. Read the issue title and full description carefully. Note:
32
32
- What type of work is it? (documentation fix, bug report, accessibility improvement, new content)
@@ -488,7 +488,7 @@ Or from within a project:
488
488
489
489
## Practical Organization Strategy for the Hackathon
490
490
491
-
Here is a recommended structure for the `learning-room` sandbox project:
491
+
Here is a recommended structure for the [learning-room](https://github.com/Community-Access/learning-room) sandbox project:
Copy file name to clipboardExpand all lines: docs/10-notifications.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,11 +24,11 @@ For this workshop, Chapter 10 is a **guided practice chapter**, not a graded aut
24
24
25
25
**Goal:** Set up a useful notification workflow so you can keep up with reviews, mentions, and assignments without inbox overload.
26
26
27
-
**Where you are working:** the GitHub.com notifications page and the `learning-room` repository settings.
27
+
**Where you are working:** the GitHub.com notifications page and the [learning-room](https://github.com/Community-Access/learning-room) repository settings.
28
28
29
29
**Estimated time:** 5-8 minutes.
30
30
31
-
1. Open the `learning-room` repository on GitHub.com.
31
+
1. Open the [learning-room](https://github.com/Community-Access/learning-room) repository on GitHub.com.
32
32
2. Find the **Watch** button near the top-right of the repository page (next to Star and Fork).
33
33
3. Activate the **Watch** dropdown and select **Participating and @mentions**. This means you only get notified when someone @mentions you or you are directly participating in a thread.
34
34
4. Open the notifications inbox by navigating to `https://github.com/notifications` (or activate the bell icon in the GitHub header).
@@ -454,7 +454,7 @@ Go to [github.com/notifications](https://github.com/notifications) and practice:
454
454
> Once you have mastered manual notification management:
455
455
>
456
456
> -**In VS Code** - `@daily-briefing morning briefing` delivers the same information as your notification inbox, organized by priority and actionability, with the ability to reply, close, and merge from inside Copilot Chat
457
-
> -**In your repo** - Fork `accessibility-agents` and every collaborator on your project can run `@daily-briefing` against your shared repository; the whole team stays aligned from a single command with no inbox required
457
+
> -**In your repo** - Fork [accessibility-agents](https://github.com/Community-Access/accessibility-agents) and every collaborator on your project can run `@daily-briefing` against your shared repository; the whole team stays aligned from a single command with no inbox required
458
458
> -**In the cloud** - GitHub Agentic Workflows can run on a schedule and post a team digest to a designated issue each morning, surfacing what needs attention before anyone opens their notifications
459
459
>
460
460
> *Your notification discipline today becomes the standard the agent enforces at scale tomorrow.*
Copy file name to clipboardExpand all lines: docs/11-git-source-control.md
+7-7Lines changed: 7 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,13 +24,13 @@ Chapter 11 is the first **local Git workflow chapter** with hands-on repository
24
24
25
25
### Chapter 11 Challenge Set
26
26
27
-
1.**Clone the sci-fi themes repository** - clone `vscode-sci-fi-themes` to your local machine using VS Code.
27
+
1.**Clone the sci-fi themes repository** - clone [vscode-sci-fi-themes](https://github.com/Community-Access/vscode-sci-fi-themes) to your local machine using VS Code.
28
28
2.**Create a branch and make one commit** - create a named branch, edit a theme file, stage, write a clear commit message, and commit locally.
29
29
3.**Push and open a linked PR** - push your branch and open a PR that references your challenge issue.
30
30
31
31
### Challenge 11.1 Step-by-Step: Clone the Sci-Fi Themes Repository
32
32
33
-
**Goal:** Get a local copy of the `vscode-sci-fi-themes` repository on your machine using VS Code.
33
+
**Goal:** Get a local copy of the [vscode-sci-fi-themes](https://github.com/Community-Access/vscode-sci-fi-themes) repository on your machine using VS Code.
34
34
35
35
**Where you are working:** VS Code desktop (or github.dev if you cannot install desktop VS Code).
36
36
@@ -47,7 +47,7 @@ This repo contains custom Copilot Chat loading phrases from three sci-fi univers
47
47
48
48
**Screen reader tip:** After step 6, VS Code shows a progress notification. NVDA reads this automatically. If you hear nothing for 30 seconds, open the Command Palette and run `Notifications: Focus Notification Toast` to check status.
49
49
50
-
**You are done when:** The `vscode-sci-fi-themes` folder is open in VS Code and you can see the `themes/` folder with its three JSON files (star-trek, hitchhikers, star-wars) in the Explorer panel.
50
+
**You are done when:** The [vscode-sci-fi-themes](https://github.com/Community-Access/vscode-sci-fi-themes) folder is open in VS Code and you can see the `themes/` folder with its three JSON files (star-trek, hitchhikers, star-wars) in the Explorer panel.
51
51
52
52
> **After cloning: check what branches exist.** A fresh clone only checks out the default branch (usually `main`), but the remote may have other branches. Run `git branch -a` in the terminal (`Ctrl+`` `) to see all branches - local and remote:
53
53
>
@@ -70,7 +70,7 @@ This repo contains custom Copilot Chat loading phrases from three sci-fi univers
70
70
71
71
**Goal:** Create a properly named branch, edit a theme file, stage the change, and commit with a clear message.
72
72
73
-
**Where you are working:** VS Code with the cloned `vscode-sci-fi-themes` repository open.
73
+
**Where you are working:** VS Code with the cloned [vscode-sci-fi-themes](https://github.com/Community-Access/vscode-sci-fi-themes) repository open.
74
74
75
75
1. Open the Command Palette: `Ctrl+Shift+P` (Mac: `Cmd+Shift+P`).
76
76
2. Type `git create branch` and select**Git: Create Branch...**
@@ -105,13 +105,13 @@ This repo contains custom Copilot Chat loading phrases from three sci-fi univers
105
105
106
106
**Screen reader tip:** The "Compare & pull request" banner is a standard link element near the top of the repository page. If your screen reader does not find it, use the heading navigation to jump to the Pull Requests tab instead.
107
107
108
-
**Cross-repo linking:** Because your challenge issue lives in `learning-room` but your PR is in `vscode-sci-fi-themes`, you use the full format `Closes Community-Access/learning-room#XX` instead of just `Closes #XX`. GitHub resolves cross-repo references automatically.
108
+
**Cross-repo linking:** Because your challenge issue lives in [learning-room](https://github.com/Community-Access/learning-room) but your PR is in [vscode-sci-fi-themes](https://github.com/Community-Access/vscode-sci-fi-themes), you use the full format `Closes Community-Access/learning-room#XX` instead of just `Closes #XX`. GitHub resolves cross-repo references automatically.
109
109
110
-
**You are done when:** Your PR appears on the Pull requests tab of `vscode-sci-fi-themes`, shows your branch name, and the description contains the cross-repo reference to your challenge issue.
110
+
**You are done when:** Your PR appears on the Pull requests tab of [vscode-sci-fi-themes](https://github.com/Community-Access/vscode-sci-fi-themes), shows your branch name, and the description contains the cross-repo reference to your challenge issue.
111
111
112
112
### Completing Chapter 11: Submit Your Evidence
113
113
114
-
Open your **assigned Chapter 11.3 challenge issue** in the `learning-room` repo and post a completion comment:
114
+
Open your **assigned Chapter 11.3 challenge issue** in the [learning-room](https://github.com/Community-Access/learning-room) repo and post a completion comment:
0 commit comments