Skip to content

PROGRESS_TRACKER.md

Latest commit

 

History

History
417 lines (321 loc) · 20.7 KB

PROGRESS_TRACKER.md

File metadata and controls

417 lines (321 loc) · 20.7 KB

Progress Tracker

Track Your Learning Journey Through the GitHub Workshop

How to Use This Tracker

  1. Print this page or save as PDF to mark progress offline
  2. Or keep a checklist in your preferred note-taking app
  3. Check off items as you complete them
  4. Return here to see your learning path and next steps

Pre-Workshop Setup

  • Created GitHub account (free tier is fine)
  • Installed Git (https://git-scm.com/download/)
  • Installed/configured VS Code or preferred editor
  • Installed GitHub CLI (gh) - optional but recommended
  • Set up SSH key or HTTPS authentication
  • Verified: git --version shows v2.20+
  • Verified: gh auth status shows you're logged in

Status: Not started In progress Complete

Chapter 0: Pre-Workshop Setup

Time: 30 minutes | What You'll Do: Get your computer ready

  • Read docs/00-pre-workshop-setup.md
  • Complete all prerequisite installations
  • Verify all tools work (git, VS Code, GitHub)
  • Set up SSH key (optional but recommended)
  • Test: Can you clone a repository? (git clone ...)

Status: Not started In progress Complete

Chapter 1: Understanding GitHub Web Structure

Time: 1 hour | What You'll Do: Learn GitHub's layout and terminology

  • Read docs/02-understanding-github.md
  • Understand: Repositories, Branches, Commits, PRs, Issues
  • Identify on any GitHub repo: Code tab, Issues tab, PR tab, Settings
  • Know the difference: Fork vs. Branch
  • Can explain: What is a pull request?

Status: Not started In progress Complete

Chapter 2: Navigating Repositories

Time: 45 minutes | What You'll Do: Practice exploring real repositories

  • Read docs/03-navigating-repositories.md
  • Navigate to 3 different repos and identify key files
  • Use keyboard navigation (accessibility focus)
  • Found: README, CONTRIBUTING, License, Issues template
  • Understand the code structure and file tree

Status: Not started In progress Complete

Chapter 3: The Learning Room

Time: 30 minutes | What You'll Do: Understand the shared practice environment

  • Read docs/04-the-learning-room.md
  • Understand: How the Learning Room automation works
  • Know: Where to find your first contribution challenge
  • Reviewed: Available practice challenges
  • Understand: How bot feedback and peer review work

Status: Not started In progress Complete

Chapter 4: Working with Issues

Time: 1 hour | What You'll Do: Create, read, and comment on issues

  • Read docs/05-working-with-issues.md
  • Create an issue in a practice repo
  • Comment on someone else's issue
  • Add a label and assignment to an issue
  • Know how to: Search issues, filter by label, use issue templates
  • Understand: Issue lifecycle (Open → In Progress → Done)

Status: Not started In progress Complete

Chapter 5: VS Code Accessibility

Time: 45 minutes | What You'll Do: Set up VS Code for accessible development

  • Read docs/11-vscode-interface.md
  • Installed: VS Code with accessibility settings configured
  • Enabled: Screen reader mode and keyboard navigation
  • Know how to: Use the Command Palette (Ctrl+Shift+P)
  • Configured: Accessibility signals and editor preferences for your workflow

Status: Not started In progress Complete

Chapter 6: Working with Pull Requests

Time: 1 hour | What You'll Do: Submit, review, and merge PRs

  • Read docs/06-working-with-pull-requests.md
  • Create a pull request
  • Review a PR and add comments
  • Respond to PR feedback
  • Know how to: See diff, leave suggestions, approve
  • Understand: PR merge strategies (Merge, Squash, Rebase)

Status: Not started In progress Complete

Chapter 7: Merge Conflicts

Time: 1 hour | What You'll Do: Resolve conflicts between branches

  • Read docs/07-merge-conflicts.md
  • Understand: Why conflicts happen
  • Know how to: Identify conflict markers (<<<< ==== >>>>)
  • Successfully resolved: 1+ real merge conflict
  • Know the "abort" option: git merge --abort

Status: Not started In progress Complete

Chapter 8: Culture & Etiquette

Time: 30 minutes | What You'll Do: Learn collaborative best practices

  • Read docs/08-open-source-culture.md
  • Understand: Respectful code review
  • Know the difference: Suggestion vs. Requirement
  • Can give constructive feedback on code
  • Understand: Inclusive language in issues/PRs

Status: Not started In progress Complete

Chapter 9: Labels, Milestones & Projects

Time: 45 minutes | What You'll Do: Use GitHub's organizational tools

  • Read docs/09-labels-milestones-projects.md
  • Created: 3+ labels for a repo or issue
  • Created: 1+ milestone (release or sprint)
  • Used project board to organize work (optional: add columns and cards)
  • Filtered issues using: Labels + Milestones

Status: Not started In progress Complete

Chapter 10: Notifications

Time: 30 minutes | What You'll Do: Master GitHub notifications

  • Read docs/10-notifications-and-day-1-close.md
  • Set up notifications: Email or in-app
  • Understand: @mentions, subscriptions, digest settings
  • Configured: Notifications for your projects
  • Know how to: Unsubscribe from threads you don't need

Status: Not started In progress Complete

Chapter 11: VS Code Interface and Setup

Time: 45 minutes | What You'll Do: Launch VS Code, sign in, enable screen reader mode, and orient to core surfaces

  • Read docs/11-vscode-interface.md
  • Know how to: Open github.dev or desktop VS Code from a repository
  • Used: Explorer, Command Palette, Outline, and Status Bar
  • Verified: GitHub sign-in and Copilot status
  • Configured: Screen reader mode and basic navigation preferences

Status: Not started In progress Complete

Chapter 12: VS Code Accessibility Deep Dive

Time: 45 minutes | What You'll Do: Configure VS Code accessibility features for daily contribution work

  • Read docs/12-vscode-accessibility.md
  • Know how to: Use Accessible View, Accessible Help, and Accessible Diff Viewer
  • Configured: Audio cues or accessibility signals as needed
  • Understand: Problems panel, Terminal, and Markdown authoring accessibility
  • Practice: Navigated a diff or diagnostic output with the keyboard

Status: Not started In progress Complete

Chapter 13: How Git Works

Time: 30 minutes | What You'll Do: Build the mental model for commits, branches, remotes, and conflicts

  • Read docs/13-how-git-works.md
  • Understand: Working tree, staging area, local repository, and remote repository
  • Know how to: Explain branch, commit, push, pull, fetch, and merge
  • Understand: Why merge conflicts happen

Status: Not started In progress Complete

Chapter 14: Git in Practice

Time: 1 hour | What You'll Do: Master Git operations within VS Code

  • Read docs/14-git-in-practice.md
  • Know how to: Clone, branch, commit, push from VS Code
  • Used: Source Control panel (Ctrl+Shift+G)
  • Understand: Staging, committing, and syncing changes
  • Configured: Git credentials and remote tracking

Status: Not started In progress Complete

Chapter 15: Code Review

Time: 1.5 hours + Exercises | What You'll Do: Review pull requests accessibly and constructively

Reading & Concepts

  • Read docs/15-code-review.md
  • Installed: GitHub Pull Requests and Issues extension
  • Know how to: View, review, and create PRs in VS Code
  • Understand: Accessible code review principles
  • Familiar with: VS Code Accessible Diff Viewer (F7)

Exercises

  • Exercise A: Review issue accessibility using web reader
  • Exercise B: Use VS Code Accessible Diff Viewer
  • Exercise C: Comment on PR accessibility

Status: Not started In progress Complete
Exercises Completed: A B C All

Chapter 16: GitHub Copilot

Time: 1 hour | What You'll Do: Use AI-assisted coding and chat

  • Read docs/16-github-copilot.md
  • Installed: GitHub Copilot and Copilot Chat extensions
  • Verified: Copilot Chat works (Ctrl+Shift+I)
  • Know how to: Use inline suggestions, chat, and custom instructions
  • Understand: Chat participants, agents, and model selection

Status: Not started In progress Complete

Chapter 17: Issue Templates

Time: 1.5 hours + Exercises | What You'll Do: Create accessible issue templates

Reading & Concepts

  • Read docs/17-issue-templates.md
  • Understand: YAML syntax for templates
  • Know how to: Create and test custom templates
  • Understand: Form accessibility in templates

Exercises

  • Exercise A: Create template using GitHub web UI
  • Exercise B: Create template locally in VS Code
  • Exercise C: Create PR for accessibility template
  • Exercise D: Design custom template for your project

Status: Not started In progress Complete
Exercises Completed: A B C D All

Chapter 19: Accessibility Agents

Time: 1.5 hours + Exercises | What You'll Do: Automate with Copilot agents

Agents to Explore

Browse the ecosystem and try agents that match your skills (read Chapter 19 for the full landscape):

  • GitHub Workflow agents - @daily-briefing, @issue-tracker, @pr-review, @analytics, @insiders-a11y-tracker, @template-builder
  • Accessibility agents - @web-accessibility-wizard, @contrast-master, @keyboard-navigator, @markdown-a11y-assistant
  • Developer Tools agents - @python-specialist, @desktop-a11y-specialist, @a11y-tool-builder

Exercises

  • Exercise 1: Generate a template with @template-builder
    • Follow all 8 steps
    • Ask Questions workflow guided tour
    • Save generated template
    • Test locally or on GitHub
  • Exercise 2: Extend the @template-builder agent
    • Follow all 6 steps
    • Edit .github/agents/template-builder.agent.md
    • Add new Pre-Built Workflow
    • Test agent with new workflow
  • Exercise 3: Iterative refinement with agents
    • Follow all 4 steps
    • Ask agent to modify/extend template
    • Observe pattern of interaction
    • Reflection: How does iteration work with agents?

Status: Not started In progress Complete
Exercises Completed: 1 2 3 All

Appendices (Reference)

  • Appendix A: Glossary - Read as needed for term definitions
    • Saved link or printed for reference
  • Appendix B: Screen Reader Cheatsheet - Bookmark this!
  • Appendix Y: Accessing Workshop Materials - How to download, read offline, and keep updated
  • Appendix Z: GitHub Skills Catalog - All 36 modules organized into six learning paths
    • NVDA commands bookmarked
    • JAWS commands bookmarked
    • VoiceOver commands bookmarked

Overall Progress Summary

Exercises by Chapter

The workshop includes structured exercises in the following chapters. Use this table to track your exercise completion separately from chapter reading:

Chapter Exercise Description Done?
Ch 1 60-Second Orientation Press 1, D, 2, H on a repo page - prove you can navigate by ear
Ch 2 Five-Tab Tour Visit Code, Issues, PRs, file finder, and README on a real repo
Ch 3 Individual Challenges 21 challenges (16 core + 5 bonus) in docs/CHALLENGES.md
Ch 4 File Your First Issue Create an introduction issue in the Learning Room
Ch 5 Try It Right Now Open a repo in github.dev, enable screen reader mode, explore the interface
Ch 6 Read a Real PR Navigate a PR's description, conversation, and diff
Ch 7 Read a Conflict Read merge conflict markers and identify both versions
Ch 8 Rewrite One Comment Transform a dismissive review comment into constructive feedback
Ch 9 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 11 Clone, Branch, Commit Complete the full Git cycle: clone → branch → edit → stage → commit → push
Ch 12 Review a PR from VS Code Open a diff, use Accessible Diff Viewer (F7), leave a comment
Ch 13 First Copilot Conversation Ask Copilot Chat a question about your repo and read the response
Ch 14 Exercise A Complete a web-based PR review using screen reader navigation
Ch 14 Exercise B Use the VS Code Accessible Diff Viewer on the same PR
Ch 14 Exercise C Compare web vs. VS Code review and document findings
Ch 15 Exercise A Use an existing issue template in Accessibility Agents
Ch 15 Exercise B Create an accessibility bug report template locally
Ch 15 Exercise C Submit your template upstream via a real PR
Ch 15 Exercise D Design a custom template for your own project
Ch 16 Exercise 1 Generate a template with the @template-builder agent
Ch 16 Exercise 2 Extend the @template-builder agent with new workflows
Ch 16 Exercise 3 Practice iterative refinement with agents

Core Path (Recommended first)

  • Chapters 0-10: Not started In progress Complete
  • Time: ~8 hours (includes workshop time)

Advanced Path (Day 2)

  • Chapters 11-16: Not started In progress Complete
  • Time: ~5 hours (includes exercises)

Full Curriculum

  • All chapters + appendices: Not started In progress Complete
  • Time: ~13 hours total

Estimated Time Breakdown

Section Time Status
Pre-Workshop 30 min
Day 1 Core (Ch 0-10) 8 hrs
Day 2 Advanced (Ch 11-16) 5 hrs
Reference/Appendices As needed
Total ~13 hrs

Learning Path by Role

If You're a Contributor (New to collaborative coding)

Recommended order:

  1. Ch 0 (Setup) - 30 min
  2. Ch 1 (Structure) - 1 hr
  3. Ch 4 (Issues) - 1 hr
  4. Ch 6 (PRs) - 1 hr
  5. Ch 14 (Accessible Review) - 1.5 hrs
  6. Ch 16 (Accessibility Agents) - 1.5 hrs

Total: ~6.5 hours

If You're a Maintainer (Manage projects)

Recommended order:

  1. Ch 0 (Setup) - 30 min
  2. Ch 9 (Labels/Milestones) - 45 min
  3. Ch 15 (Issue Templates) - 1.5 hrs
  4. Ch 14 (Accessible Code Review) - 1.5 hrs
  5. Ch 16 (Accessibility Agents) - 1.5 hrs

Total: ~5.5 hours

If You're a Facilitator (Teaching others)

Recommended order:

  1. Full curriculum (0-16) - 11+ hours
  2. Read FACILITATOR.md
  3. Practice all exercises before leading workshop

Total: ~15 hours

Next Steps After Completing This Curriculum

Keep Learning

  • Work on real open-source projects
  • Practice code review on real PRs
  • Create templates for your own repositories
  • Experiment with agents on your own code

Share Your Knowledge

  • Lead a workshop for your team
  • Contribute improvements to this guide
  • Help others in GitHub discussions/issues

Advanced Topics (Not in This Guide)

  • GitHub Advanced Security features
  • Custom GitHub Actions
  • Codespaces for efficient development
  • GitHub Enterprise features

Questions or Stuck?

  • Check: TROUBLESHOOTING.md (common issues & fixes)
  • Search: QUICK_REFERENCE.md (commands & shortcuts)
  • Look up: docs/appendix-x-resources.md (external documentation)
  • Define: docs/appendix-a-glossary.md (term definitions)
  • Ask: Open an issue or discussion on GitHub

Last updated: February 2026
Print or bookmark this progress tracker to chart your journey!

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.