Admin & Facilitator Resources
This folder contains all administrative and facilitator documentation for running GIT Going with GitHub workshops using Hybrid, GitHub-native provisioning.
Facilitator Resources
Start here if you're running a workshop:
Quick Navigation
- FACILITATOR_RESOURCES.md - Navigation hub for all facilitator guides
- FACILITATOR_GUIDE.md - Complete workshop bible (setup through post-workshop)
- FACILITATOR_OPERATIONS.md - Hour-by-hour procedures during workshop
- ../GO-LIVE-QA-GUIDE.md - Final release-readiness guide and end-to-end test checklist
- LEARNING-ROOM-E2E-QA-RUNBOOK.md - Single step-by-step QA runbook from registration to full student completion (podcast excluded)
Supporting Guides
- FACILITATOR_CHALLENGES.md - Managing the challenge system
- FACILITATOR_ASSESSMENT.md - Assessment and grading rubric
- SUPPORT_HUB_OPERATIONS.md - Post-workshop support hub governance and triage model
Provisioning and Deployment
Hybrid provisioning is the current, owned, GitHub-native system:
- HYBRID_REVIEW_INDEX.md - Start here: catalog of the entire Hybrid deliverable
- HYBRID_DEPLOYMENT_GUIDE.md - Phase-by-phase deployment of Hybrid provisioning and optional companion
- OWNED_PROVISIONING.md - Day-to-day operations guide for the owned provisioning subsystem
- companion/README.md - Optional Flask companion (registration front door + facilitator dashboard)
Student And Enrollment Management
- STUDENT_MANAGEMENT.md - Managing student rosters, enrollments, tracking
- REGISTRATION-ADMIN.md - Registration process administration
- REGISTRATION-QUICKSTART.md - 5-minute facilitator setup for registration
- STUDENT_ONBOARDING_EMAIL.md - Template email for student onboarding
Workshop Planning And Organization
- DAY1_AGENDA.md - Day 1 schedule and agenda
- DAY2_AGENDA.md - Day 2 schedule and agenda
- DAY2_QUICK_START.md - Quick start guide for Day 2
- QUICK_REFERENCE.md - Quick reference card for facilitators
- PROGRESS_TRACKER.md - Tracking student progress
Setup And Validation
- COHORT_PROVISIONING.md - Setting up a new cohort
- ACCESSIBILITY_TESTING.md - Testing workshop for accessibility
- VALIDATION_AUDIT.md - Validating everything works
- LEARNING-ROOM-E2E-QA-RUNBOOK.md - Full registration-through-challenges QA execution path for one operator
- qa-readiness/README.md - Local unit-test readiness evidence pack (non-podcast)
- ../GO-LIVE-QA-GUIDE.md - Complete pre-cohort QA gate for content, workflows, provisioning, podcasts, and human testing
Communications
- ANNOUNCEMENT.md - Workshop announcement templates
- FAQ.md - Frequently asked questions
Reference And Support
- TROUBLESHOOTING.md - General troubleshooting reference
- REGISTER.md - Student registration information
- GITHUB_PROPOSAL.md - GitHub partnership/proposal documentation
- PODCASTS.md - Podcast episode notes and references
Typical Workflow
Planning Phase (Weeks 1-2 Before)
- HYBRID_DEPLOYMENT_GUIDE.md - Deploy provisioning infrastructure
- COHORT_PROVISIONING.md - Set up the cohort
- ANNOUNCEMENT.md - Create student announcements
- STUDENT_MANAGEMENT.md - Prepare roster
Pre-Workshop (48 Hours Before)
- FACILITATOR_GUIDE.md - Complete checklist
- ACCESSIBILITY_TESTING.md - Test with screen readers
- FACILITATOR_OPERATIONS.md - Setup workstation
During Workshop
- FACILITATOR_OPERATIONS.md - Follow hour-by-hour procedures
- PROGRESS_TRACKER.md - Track student progress
- OWNED_PROVISIONING.md - Reference for recovery if needed
Post-Workshop
- FACILITATOR_GUIDE.md - Follow-up tasks
- Update this documentation with lessons learned
Reading Order Recommendations
For First-Time Facilitators
- Start: FACILITATOR_RESOURCES.md
- Then: FACILITATOR_GUIDE.md (full read)
- Then: FACILITATOR_OPERATIONS.md (full read)
- Reference: FACILITATOR_CLASSROOM_TROUBLESHOOTING.md
For Returning Facilitators
- Quick reference: QUICK_REFERENCE.md
- Review: FACILITATOR_GUIDE.md checklist
- Keep open: FACILITATOR_OPERATIONS.md during workshop
For Admin/Coordinators
- COHORT_PROVISIONING.md - Setup cohorts
- STUDENT_MANAGEMENT.md - Manage rosters
- PROGRESS_TRACKER.md - Monitor progress
- ACCESSIBILITY_TESTING.md - Ensure quality
Key Resources By Topic
GitHub Classroom
- FACILITATOR_GUIDE.md - Complete setup
- COHORT_PROVISIONING.md - Provisioning
- classroom/README.md - Fast copy-paste setup pack
Accessibility
- ACCESSIBILITY_TESTING.md - Testing procedures
- FACILITATOR_GUIDE.md - Accessibility philosophy (throughout)
Student Communication
- ANNOUNCEMENT.md - Announcement templates
- STUDENT_ONBOARDING_EMAIL.md - Onboarding email
- FAQ.md - FAQs to share
Troubleshooting
- FACILITATOR_CLASSROOM_TROUBLESHOOTING.md - GitHub-specific issues
- TROUBLESHOOTING.md - General troubleshooting
Assessment
- FACILITATOR_ASSESSMENT.md - Grading rubric
- PROGRESS_TRACKER.md - Progress tracking
Document Index
| Document | Purpose | For Whom |
|---|---|---|
| FACILITATOR_RESOURCES.md | Navigation hub | Facilitators (start here!) |
| FACILITATOR_GUIDE.md | Complete workshop guide | New facilitators |
| FACILITATOR_OPERATIONS.md | Hour-by-hour procedures | Active facilitators |
| FACILITATOR_CLASSROOM_TROUBLESHOOTING.md | Problem-solving | All facilitators |
| FACILITATOR_CHALLENGES.md | Challenge management | Experienced facilitators |
| FACILITATOR_ASSESSMENT.md | Grading rubric | Facilitators doing assessment |
| COHORT_PROVISIONING.md | Setup checklist | Admin/coordinators |
| STUDENT_MANAGEMENT.md | Roster management | Admin/coordinators |
| PROGRESS_TRACKER.md | Student tracking | Facilitators, coordinators |
| ACCESSIBILITY_TESTING.md | A11y testing | QA/admin |
| DAY1_AGENDA.md | Day 1 schedule | Everyone |
| DAY2_AGENDA.md | Day 2 schedule | Everyone |
| QUICK_REFERENCE.md | Quick reference card | Facilitators (print this) |
| FAQ.md | Frequently asked questions | Students (and facilitators) |
| ANNOUNCEMENT.md | Announcement templates | Admin |
| TROUBLESHOOTING.md | General troubleshooting | Everyone |
Related Folders
- ../classroom/ - GitHub Classroom deployment and configuration
- ../docs/ - Student-facing guides and learning materials
- scripts/ - Automation and utility scripts
Questions Or Feedback?
Found something unclear or outdated? Update this documentation to help the next facilitator. Your experience makes this better for everyone.
Last Updated: May 2026 | Maintained by: Jeff Bishop | Version: 2.0
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.
- Facilitator Resources: GitHub Docs, home, GitHub Changelog
- Student And Enrollment Management: GitHub Docs, home, GitHub Changelog
- Workshop Planning And Organization: GitHub Docs, home, GitHub Changelog, GitHub Projects docs, Labels docs, Milestones docs
- Setup And Deployment: GitHub Docs, home, GitHub Changelog
- Communications: GitHub Docs, home, GitHub Changelog
- Reference And Support: GitHub Docs, home, GitHub Changelog
- Typical Workflow: GitHub Docs, home, GitHub Changelog, Workflow syntax for GitHub Actions, Secure use reference for GitHub Actions, GitHub Actions changelog
- Reading Order Recommendations: GitHub Docs, home, GitHub Changelog
- Key Resources By Topic: GitHub Docs, home, GitHub Changelog
- Document Index: GitHub Docs, home, GitHub Changelog
- Related Folders: GitHub Docs, home, GitHub Changelog
- Questions Or Feedback?: GitHub Docs, home, GitHub Changelog