Welcome to Git Going with GitHub
A tour of the workshop structure, the two-day arc, and what you will accomplish.
Listen
Transcript
Alex: Welcome to Git Going with GitHub. This episode is the front porch for the workshop: what you are building, where the pieces live, and why the path is designed the way it is.
Jamie: I like that phrase, front porch. Because if someone is brand new to GitHub, open source, VS Code, or the command line, the first question is probably, am I already supposed to know all of this?
Alex: No. Open source means people collaborate on projects where the work is visible, reviewable, and shared under rules that allow others to use or improve it. In this workshop, that collaboration is not pretend. You will practice the same GitHub workflow that real projects use.
Jamie: So open source is not just code sitting somewhere public. It is people proposing changes, discussing them, reviewing them, and deciding what should become part of the project.
Alex: Exactly. And accessibility work belongs in that conversation because small improvements can remove real barriers. The workshop gives you a supported place to learn the mechanics before you carry those skills into larger community projects.
Jamie: The materials also say this course is actively maintained. That feels important, because GitHub pages and VS Code screens do change.
Alex: They do. The course guide is your table of contents, and the Learning Room is your personal workshop space. The materials are being refined for the May 2026 cohort, so you should expect updates before and during the course.
Jamie: What happens if a button name or page order does not match what the chapter says?
Alex: Do not treat that as failure. Check the URL, the browser tab title, the page heading, landmarks, tab names, button labels, keyboard help, and in VS Code, the Command Palette. Then ask a facilitator or report the mismatch with the page link, the step that differed, and what your screen reader announced or what you observed.
Alex: The workshop has a two-day shape. Day 1 is GitHub foundations in the browser: navigating repositories, using issues, making branches and commits, opening a pull request, reviewing, and merging.
Jamie: Can we preview those words quickly? Because repository, issue, pull request, and merge can sound like a wall of vocabulary.
Alex: A repository is the project space. It holds files, history, issues, and pull requests. An issue is a tracked conversation about work to do, a bug, a question, or an improvement. A pull request, often shortened to PR, is a proposed change that other people can review before it becomes part of the project.
Jamie: And merge is the moment the approved change is brought into the main project history.
Alex: Right. A branch is a safe working line for your change, and a commit is a saved snapshot with a message. In Day 1, those contributions happen in your own provisioned Learning Room repository, so you can practice issue, branch, commit, pull request, and merge without risking a public project.
Jamie: Then Day 2 moves out of the browser-only world.
Alex: Yes. Day 2 is VS Code, Git, GitHub Copilot, and the Accessibility Agents ecosystem. Some workshop materials may describe a snapshot, for example 55 accessibility agents organized across 3 teams. The safest way to remember it is that Accessibility Agents is a living catalog: agents can be added, revised, or reorganized as the course grows.
Jamie: And the course is not saying, let the agents do magic before you know what is happening.
Alex: Right. You learn the manual workflow first, then you see how automation can support it. There is also a bridge between the two days: on many GitHub repository pages, pressing the period key opens github.dev, which gives you a VS Code-style editor in the browser. It is useful, but it has limits: no local terminal or debugger, web-compatible extensions only, and not the full desktop agent workflow.
Jamie: Before someone gets to all that, what should they do first?
Alex: Start with the pre-workshop setup. It helps you create or verify your GitHub account, choose a browser, install Git, install VS Code for Day 2, and configure your screen reader for GitHub. Plan about 30 minutes, and if setup is not finished before the workshop, tell a facilitator early.
Jamie: Then comes the GitHub Classroom assignment link, right?
Alex: Yes. The facilitator gives you a link that usually starts with https://classroom.github.com/a/. Open it in the browser where you are signed in to GitHub, authorize GitHub Classroom if asked, choose your name from the roster if prompted, accept the assignment, wait for the repository to be created, refresh until the repository link appears, and bookmark it.
Jamie: That repository name usually looks like learning-room-your-username.
Alex: Exactly. It is private to you unless the facilitator intentionally pairs you with someone. Everyone starts from the same template, but your issues, branches, commits, pull requests, mistakes, fixes, and bot feedback belong to your learning process.
Jamie: Once the Learning Room exists, how does a learner know what to do first?
Alex: The Student Progression Bot creates Challenge 1: Find Your Way Around. Open your Learning Room, go to the Issues tab, or use GitHub's keyboard shortcut G then I, find that challenge issue, and read it from top to bottom before activating controls.
Jamie: The issue itself tells you what to do and what evidence to post.
Alex: Yes. Evidence might be a comment, a field, or another requested trace of the work. When the instructions tell you to close the challenge issue, closing it triggers the next challenge. You are not expected to search the whole curriculum to guess the next task.
Jamie: There are a lot of tools named in the guide: browser, github.dev, VS Code, GitHub Desktop, GitHub CLI. How should someone choose without feeling behind?
Alex: Use the tool that fits the moment. The browser is best for Day 1, issues, repository navigation, pull requests, and reviews. github.dev is helpful when you want a VS Code-like editor without installing anything. VS Code desktop is best for Day 2 work with local Git, Copilot, extensions, and deeper editing.
Jamie: And GitHub Desktop or the command line are options, not secret requirements.
Alex: Exactly. GitHub Desktop gives you a visual desktop Git workflow. GitHub CLI is useful if you like terminal workflows or want automation later. If the command line is new to you, you still belong here; the course keeps returning to the contribution workflow itself: issue, branch, change, commit, pull request, review, and merge.
Alex: When you feel lost with a screen reader, listen for structure before you act. Useful signals include the page title, repository name heading, landmarks like main content or repository navigation, tab names such as Code, Issues, and Pull requests, issue or pull request titles, branch names, button names, field labels, bot comments, and check results.
Jamie: So the move is not to press keys faster. It is to pause, find where you are, and then decide.
Alex: Yes. And the course has built-in support. Every challenge has instructions and evidence prompts, chapters include stuck points, reference solutions are available after you try, Gandalf posts educational feedback on pull requests, and facilitators and peers are part of the learning system. If you are still stuck, open a support issue and include what you tried, what happened, what you expected, plus your screen reader and operating system.
Jamie: How do the chapters, appendices, podcasts, and exercises fit together?
Alex: The live agenda is intentionally smaller than the full curriculum. Live sessions focus on the core contribution path, while the full chapter set is there for preparation, catch-up, remote participation, and follow-up. Day 1 runs from setup and tool choice through GitHub navigation, the Learning Room, issues, pull requests, merge conflicts, open source culture, labels, notifications, and the Day 1 close.
Jamie: And Day 2 maps those browser skills into VS Code and a more complete contribution process.
Alex: Right. Day 2 covers VS Code setup, accessibility features, how Git works, Git in practice, code review, Copilot, issue templates, fork-based contribution, Accessibility Agents, the Capstone Project, and what comes next. Challenge 15 is browse-first discovery of Accessibility Agents, not a requirement to fork that repository. Completing Challenge 15 opens Challenge 16, titled Capstone Project, plus Bonus Challenges A through E; the capstone can be a contribution to Accessibility Agents, GLOW, or another meaningful repository, and review-ready drafts or contribution plans can be valid evidence.
Jamie: The appendices sound like the place to go when you need a quick answer rather than a full lesson.
Alex: Yes. Keep the glossary and screen reader cheat sheet handy. Other reference material covers core workshop help, deeper Git topics, VS Code and Copilot, GitHub platform features, community practice, troubleshooting, quick reference, and resources for continued learning. The course also points to official GitHub docs and the changelog when you need the current source of truth.
Jamie: And the exercises have a pattern: Try It, You are done when, and What success feels like.
Alex: That pattern matters because it makes practice checkable. Try It gives you the action, You are done when tells you the finish line, and What success feels like helps you recognize the result, especially when you are navigating by sound, keyboard focus, and page structure.
Jamie: What is the first success check for someone who just accepted the assignment?
Alex: You are ready to continue when you can say four things: I can open my Learning Room repository, I can find the Issues tab, I can open Challenge 1, and I know where to post evidence and how to ask for help.
Jamie: That is refreshingly small. Not, I understand all of Git. Not, I can solve every merge conflict.
Alex: Exactly. If you want the gentlest path, go from pre-workshop setup to choosing your tools, understanding GitHub, navigating repositories, learning the Learning Room, and then your Challenge 1 issue. You belong here, and the course will keep making the next step explicit.
Workshop Content
Companion Podcast and Transcript
Use audio and transcript companions to review concepts in a conversational format.
Welcome to Git Going with GitHub
Companion audio: this episode reinforces key ideas and may not be a word-for-word reading of this page.
Open audio file (external) Full transcript source (external)
Transcript preview
Alex: Welcome to Git Going with GitHub. This episode is the front porch for the workshop: what you are building, where the pieces live, and why the path is designed the way it is.
Jamie: I like that phrase, front porch. Because if someone is brand new to GitHub, open source, VS Code, or the command line, the first question is probably, am I already supposed to know all of this?
Alex: No. Open source means people collaborate on projects where the work is visible, reviewable, and shared under rules that allow others to use or improve it. In this workshop, that collaboration is not pretend. You will practice the same GitHub workflow that real projects use.
Jamie: So open source is not just code sitting somewhere public. It is people proposing changes, discussing them, reviewing them, and deciding what should become part of the project.
Course Guide
Listen to Episode 0: Welcome to Git Going with GitHub - a conversational audio overview of this chapter. Listen before reading to preview the concepts, or after to reinforce what you learned.
GitHub Learning Room - Your Complete Workshop Companion
Welcome. You are about to begin a two-day journey into open source collaboration using GitHub, VS Code, and GitHub Copilot - all designed for screen reader and keyboard-only navigation. This guide is your starting point and table of contents for everything in this workshop.
Note: Workshop content is being actively refined for the May 2026 cohort. Students should expect updates to materials leading up to and during the course.
Important: tools and websites change. GitHub.com, GitHub Classroom, VS Code, GitHub Copilot, github.dev, browser extensions, and agent experiences are living products. We do our best to keep this curriculum current and source-backed, but labels, page order, shortcuts, preview features, model availability, and account-policy behavior can shift. If the documentation and your screen differ, use the exploration pattern taught in Chapters 2 and 3: orient by URL, page title, H1, landmarks, tab names, button labels, keyboard help, and the VS Code Command Palette. Then report the mismatch so the documentation can be corrected.
How This Course Works
This is a two-day workshop built around one idea: you will make real contributions to a real open source project. Not simulated. Not pretend. Real.
Live Agenda and Self-Paced Curriculum
The live hackathon agenda is intentionally smaller than the full curriculum. Live sessions prioritize the core contribution path, while the complete chapter set remains available for self-paced preparation, catch-up, remote participation, and post-event continuation.
- Live core: The facilitator chooses the minimum path needed for participants to make and understand a real contribution.
- Async follow-up: Chapters and challenges not covered live can be completed after the session using the Learning Room, solutions, podcasts, and Slack channel.
- Remote participation: Remote cohorts should use the same checkpoints and evidence prompts, with written instructions available before each live block.
The Two Days
Day 1 - GitHub Foundations (Browser)
You learn GitHub's web interface using only your keyboard and screen reader. The live Day 1 core path gets you through repository navigation, issues, branches, commits, and a first pull request. Review practice, merge conflicts, labels, notifications, and culture exercises remain available as stretch or async follow-up.
Day 2 - VS Code + Accessibility Agents (Desktop)
You move to Visual Studio Code, learn GitHub Copilot, and activate the Accessibility Agents ecosystem. The live Day 2 core path prepares you to make a real contribution, and the async continuation path gives you time to polish and submit it well.
The Journey Arc
Day 1 - Learn the skill in the browser
Navigate → Issue → Pull Request → Review → Merge
↓ (bridge: press . on any GitHub repo - VS Code opens in your browser)
github.dev - VS Code on the web, no install needed
Same keyboard shortcuts · Same screen reader mode · Edit files · Open PRs
Limits: no local terminal or debugger, only web-compatible extensions, and not the full desktop agent workflow
↓ (you've earned the desktop - now it makes sense)
Day 2 - Deepen with VS Code + Accessibility Agents
VS Code basics → Copilot inline → Copilot Chat
@daily-briefing → @issue-tracker → @pr-review → @analytics → prepare upstream
The key principle: Learn the manual skill first, then see how it is automated. The agents only make sense when you already understand what they are doing.
Before You Begin
Start with Get Going with GitHub if you want the most guided path. It explains how GitHub Classroom creates your private Learning Room repository, how Challenge 1 appears, how evidence prompts work, and how to choose between browser, github.dev, VS Code, GitHub Desktop, and command-line paths.
Complete everything in Chapter 00: Pre-Workshop Setup before Day 1. This chapter walks you through:
- Creating a GitHub account
- Installing Git
- Setting up VS Code (optional for Day 1, required for Day 2)
- Configuring your screen reader for GitHub
- Verifying everything works
Time needed: About 30 minutes.
Companion Audio Series
Every chapter and appendix has a companion podcast episode - a conversational two-host overview that previews or reviews the key concepts. Listen before reading a chapter to know what to expect, or after to reinforce what you learned.
- Browse the podcast episodes with HTML5 audio players
- Subscribe via RSS in your preferred podcast app
- Episodes are 8-18 minutes each - perfect for commutes, walks, or screen reader breaks
Day 1: GitHub Foundations
These chapters are designed to be read and practiced in order. Each builds on the one before it.
| # | Chapter | What You Will Learn | Time |
|---|---|---|---|
| Start | Get Going with GitHub | GitHub Classroom onboarding, Learning Room first steps, support, and tool choice | 15 min |
| 00 | Pre-Workshop Setup | Install and configure everything before Day 1 | 30 min |
| 01 | Choose Your Adventure: A Tool Tour | Explore the 5 tool environments before you start | 30 min |
| 02 | Understanding GitHub's Web Structure | How GitHub is organized - page types, headings, landmarks, screen reader orientation | 1 hr |
| 03 | Navigating Repositories | Explore any repo using your screen reader - tabs, files, commits, branches | 45 min |
| 04 | The Learning Room | Your shared practice environment - challenges, PR workflow, bot feedback, peer review | 30 min |
| 05 | Working with Issues | File, search, filter, comment on, and manage issues | 1 hr |
| 06 | Working with Pull Requests | Create, review, comment on, and merge pull requests | 1 hr |
| 07 | Merge Conflicts | Understand why conflicts happen and how to resolve them | 1 hr |
| 08 | Open Source Culture and Contributing | Communication, tone, reviews, inclusive language, your first contribution | 30 min |
| 09 | Labels, Milestones and Projects | Organize and cross-reference work | 45 min |
| 10 | Notifications and Day 1 Close | Manage your inbox, @mentions, and subscriptions; recap Day 1 | 30 min |
Day 1 self-paced total: ~8 hours. The live Day 1 agenda covers the core path in a shorter Pacific-time event day and treats later challenges as stretch or async follow-up.
Day 2: VS Code + Accessibility Agents
Day 2 moves you from the browser to the desktop. Every skill maps directly to what you learned on Day 1.
| # | Chapter | What You Will Learn | Time |
|---|---|---|---|
| 11 | VS Code: Interface and Setup | Launch VS Code, sign in, screen reader mode, Activity Bar, Settings, shortcuts | 45 min |
| 12 | VS Code: Accessibility Deep Dive | Keyboard navigation, Problems panel, Terminal, Copilot Chat, Accessible Help/View/Diff, Signals, Speech | 45 min |
| 13 | How Git Works: The Mental Model | Commits, branches, local vs remote, push/pull/fetch, why conflicts happen | 30 min |
| 14 | Git in Practice | Clone, branch, stage, commit, push, merge - all from VS Code | 1 hr |
| 15 | Code Review: PRs, Diffs, and Feedback | PR extension, accessible diffs, inline comments, the reviewer's craft | 1.5 hrs |
| 16 | GitHub Copilot | Inline suggestions, Copilot Chat, effective prompting, custom instructions | 1 hr |
| 17 | Issue Templates | Create and customize GitHub issue templates with YAML | 1 hr |
| 18 | Fork and Contribute | The complete fork-based open source contribution workflow | 45 min |
| 19 | Accessibility Agents | Agent files, prompts, skills, and contribution paths across the ecosystem | 1 hr |
| 20 | Capstone Project | Choose Accessibility Agents, GLOW, or another project and create an impactful agentic contribution | 1.5 hrs |
| 22 | What Comes Next | Graduation, portfolio, continued learning, community | 30 min |
Day 2 self-paced total: ~10 hours. The live Day 2 agenda focuses on VS Code, Git, Copilot, agent discovery, and supported contribution work; deeper capstone material can continue asynchronously.
Appendices - Reference Material
Open these at any time during the workshop. They are not part of the chapter sequence - use them when you need them.
Always Open (Bookmark These)
| Appendix | Document | What It Covers |
|---|---|---|
| A | Glossary | Every term, concept, and piece of jargon explained |
| B | Screen Reader Cheat Sheet | NVDA, JAWS, and VoiceOver navigation commands plus GitHub keyboard shortcuts |
Core Reference (C-D)
| Appendix | Document | What It Covers |
|---|---|---|
| C | Markdown and GitHub Flavored Markdown | Complete guide from basics through GFM - headings, lists, links, tables, alerts, Mermaid, math, footnotes |
| D | Git Authentication | SSH keys, Personal Access Tokens, credential storage, commit signing |
Git Deep Dive (E-F)
| Appendix | Document | What It Covers |
|---|---|---|
| E | Advanced Git Operations | Cherry-pick, interactive rebase, reset, revert, tags, detached HEAD, force push, bisect, git clean |
| F | Git Security for Contributors | .gitignore deep dive, env variables, pre-commit hooks, secrets recovery, push protection |
VS Code and Copilot (G-L)
| Appendix | Document | What It Covers |
|---|---|---|
| G | VS Code Accessibility Reference | All accessibility settings, audio signals, diff viewer, screen reader configs |
| H | GitHub Desktop | Visual Git client - clone, branch, stage, commit, push, cherry-pick, conflict resolution |
| I | GitHub CLI Reference | Installing, auth, repos, issues, PRs, releases, search, aliases, extensions, Copilot CLI |
| J | Cloud Editors (Codespaces and github.dev) | Cloud development environments, accessibility setup, screen reader usage |
| K | Copilot Reference | Features, chat participants, slash commands, MCP servers, billing, and model-selection guidance |
| L | Accessibility Agents Reference | 55 agents, 3 teams, 5 platforms, slash commands, workspace configuration |
GitHub Platform (M-S)
| Appendix | Document | What It Covers |
|---|---|---|
| M | Accessibility Standards Reference | WCAG 2.2, ARIA roles and patterns, PR accessibility checklist |
| N | Advanced Search | Complete query language reference for issues, PRs, code, and repos |
| O | Branch Protection and Rulesets | Required reviews, status checks, diagnosing blocked PRs |
| P | Security Features | Dependabot, secret scanning, code scanning, private advisories |
| Q | GitHub Actions and Workflows | Automation, CI/CD, agentic workflows |
| R | GitHub Projects Deep Dive | Boards, tables, roadmaps, custom fields, cross-repo projects |
| S | Releases, Tags, and Insights | Versioned releases, semver, pulse, contributors, traffic |
Community and Continuing (T-Z)
| Appendix | Document | What It Covers |
|---|---|---|
| T | Community and Social | Profiles, sponsors, wikis, organizations, templates, stars, following, topics |
| U | Discussions and Gists | Forum-style conversations, Q&A, polls, code snippets, sharing |
| V | GitHub Mobile | VoiceOver and TalkBack guide for iOS and Android |
| W | Publishing with GitHub Pages | Deploy a static site from your repository |
| X | Resources | Every link, tool, and reference from this event |
| Y | Accessing Workshop Materials | How to download, read offline, and keep updated |
| Z | GitHub Skills - Complete Course Catalog | All 36 modules in six learning paths with links and prerequisites |
Exercises at a Glance
The workshop includes structured exercises across the curriculum. Every exercise is designed to be completed in 1-5 minutes, is impossible to fail, and follows the same pattern: Try It -> You're done when -> What success feels like.
Note: Exercise details will be updated as chapter content is finalized in Phases 2-5. The exercises below reflect the new chapter numbers.
| Chapter | Exercise | What You Do |
|---|---|---|
| Ch 02 | 60-Second Orientation | Press 1, D, 2, H on a repo page - prove you can navigate by ear |
| Ch 03 | Five-Tab Tour | Visit Code, Issues, PRs, file finder, and README on a real repo |
| Ch 04 | Individual Challenges | Progressive challenges in the Learning Room |
| Ch 04 | Group Challenges | Collaborative exercises in the Learning Room |
| Ch 05 | File Your First Issue | Create an introduction issue in the Learning Room |
| Ch 06 | Read a Real PR | Navigate a PR's description, conversation, and diff |
| Ch 07 | Read a Conflict | Read merge conflict markers and identify both versions |
| Ch 08 | Rewrite One Comment | Transform a dismissive review comment into constructive feedback |
| Ch 09 | Label and Link | Add a label to an issue and create a cross-reference |
| Ch 10 | Tame Your Inbox | Mark a notification as done and configure watch settings |
| Ch 14 | Clone, Branch, Commit | Complete the full Git cycle: clone, branch, edit, stage, commit, push |
| Ch 15 | Review a PR from VS Code | Open a diff, use Accessible Diff Viewer (F7), leave a comment |
| Ch 16 | First Copilot Conversation | Ask Copilot Chat a question about your repo and read the response |
| Ch 17 | Use an Issue Template | Use an existing issue template in Accessibility Agents |
| Ch 17 | Create a Template | Create an accessibility bug report template locally |
| Ch 17 | Submit Upstream | Submit your template upstream via a real PR |
| Ch 19 | Agent Exercises | Generate, extend, and iterate with accessibility agents |
| Ch 20 | Capstone | Design, build, and contribute an accessibility agent |
Getting Help
If you get stuck at any point during the workshop, these resources are always available:
| Resource | What It Is | When to Use It |
|---|---|---|
| FAQ | Answers to common questions | When you have a question about the workshop, GitHub, or screen readers |
| Troubleshooting | Step-by-step solutions to common problems | When something is not working |
| Quick Reference | Condensed shortcuts and commands | When you need a keyboard shortcut or command fast |
| Glossary | Term definitions | When you encounter an unfamiliar word |
| Screen Reader Cheat Sheet | Navigation commands | When you need a screen reader shortcut |
| Resources | External links and documentation | When you want to learn more about a topic |
Still stuck? Open a support issue at https://github.com/Community-Access/support/issues describing what you tried, what happened, and what you expected. Include your screen reader and operating system.
Workshop at a Glance
| Aspect | Day 1 | Day 2 |
|---|---|---|
| Focus | GitHub web interface | VS Code + Accessibility Agents |
| Tools | Browser, screen reader | VS Code, Copilot, Accessibility Agents |
| Chapters | 00-10 (11 chapters) | 11-21 (11 chapters) |
| Skills | Navigate, Issue, PR, Review, Merge | Git, Copilot, Agents, Fork, Capstone |
| Outcome | You can use GitHub independently | You have a real contribution path and review process |
| Time | ~8 hours | ~10 hours |
Ready to begin? Start with Chapter 00: Pre-Workshop Setup.
Last updated: May 2026
Authoritative Sources
Use these official references when you need the current source of truth for facts in this chapter.
Section-Level Source Map
Use this map to verify facts for each major section in this file.
- GitHub Learning Room - Your Complete Workshop Companion: GitHub Docs, home, GitHub Changelog, About Git, GitHub flow, About pull requests
- How This Course Works: GitHub Docs, home, GitHub Changelog
- Before You Begin: GitHub Docs, home, GitHub Changelog
- Companion Audio Series: GitHub Docs, home, GitHub Changelog
- Day 1: GitHub Foundations: GitHub Docs, home, GitHub Changelog, About Git, GitHub flow, About pull requests
- Day 2: VS Code + Accessibility Agents: GitHub Docs, home, GitHub Changelog, GitHub Copilot docs, Custom instructions support matrix, About custom agents
- Appendices - Reference Material: GitHub Docs, home, GitHub Changelog
- Exercises at a Glance: GitHub Docs, home, GitHub Changelog
- Getting Help: GitHub Docs, home, GitHub Changelog
- Workshop at a Glance: GitHub Docs, home, GitHub Changelog