Course Overview Episode 0 10-12 min

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

Full chapter content from the Git Going with GitHub workshop guide.

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.

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.

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.