A 2-hour hands-on training course for ~100 developers migrating from Gerrit and Jenkins to GitHub.
The course centres on OctoTasks — a simple Node.js task-manager web app that participants browse, modify, review, and ship during the session.
| Resource | Location |
|---|---|
| 📖 Docs site | https://<org>.github.io/training/ |
| 🗂️ Trainer walkthroughs | walkthrough/ |
| 📚 Wiki | Repository wiki |
| ⚙️ Setup guide | docs/setup.html |
training/
├── src/ # OctoTasks web app (Node.js / Express)
│ ├── app.js # Server entry point
│ ├── store.js # In-memory task store
│ ├── routes/tasks.js # REST API (/api/tasks)
│ └── public/ # Frontend (HTML / CSS / JS)
├── tests/
│ └── tasks.test.js # Jest test suite (16 tests)
├── docs/ # GitHub Pages documentation site
│ ├── index.html # Course overview & agenda
│ ├── api.html # API reference
│ └── setup.html # Instructor setup guide
├── walkthrough/ # Trainer step-by-step guides (one per section)
│ ├── README.md # Index + pre-session checklist
│ ├── 01-welcome.md
│ ├── 02-navigating-github.md
│ ├── 03-repository-basics.md
│ ├── 04-github-flow.md # ← core live demo section
│ ├── 05-github-copilot.md
│ ├── 06-github-actions.md
│ ├── 07-putting-it-together.md
│ └── 08-wrap-up.md
├── wiki/ # Wiki page sources (synced to the GitHub Wiki)
│ ├── Home.md
│ ├── GitHub-Flow.md
│ ├── Setup-Guide.md
│ └── Gerrit-vs-GitHub.md
└── .github/
├── workflows/
│ ├── ci.yml # Lint + test on push/PR
│ ├── pages.yml # Deploy docs/ to GitHub Pages
│ └── setup-training.yml # One-click seed: issues, PRs, project
├── ISSUE_TEMPLATE/
│ ├── bug_report.yml
│ └── feature_request.yml
├── pull_request_template.md
└── CODEOWNERS
git clone https://github.com/queuedecay/training.git
cd training
npm install
npm start # → http://localhost:3000npm test # Run Jest tests (16 passing)
npm run lint # Run ESLint
npm run dev # Dev server with auto-restart| Time | Section |
|---|---|
| 0:00 – 0:10 | Welcome & Objectives |
| 0:10 – 0:25 | Navigating GitHub |
| 0:25 – 0:45 | Repository Basics |
| 0:45 – 1:05 | GitHub Flow (core live demo) |
| 1:05 – 1:10 | GitHub Copilot & AI (conceptual overview) |
| 1:10 – 1:25 | GitHub Actions – Simple Demo |
| 1:25 – 1:40 | Putting It All Together |
| 1:40 – 1:45 | Wrap-Up & Next Steps + Q&A |
- Run Actions → Setup Training Environment (workflow_dispatch) to seed issues, PRs, and a project board.
- Enable GitHub Pages (Settings → Pages → Source: GitHub Actions).
- Enable branch protection on
main(require theTestCI job). - Enable the repository wiki in GitHub so the Sync GitHub Wiki workflow can publish
wiki/*.mdas individual wiki pages. - Share the Pages URL with participants.
Changes pushed to wiki/*.md on main are automatically published to the GitHub Wiki by .github/workflows/wiki-sync.yml.
Full instructions: docs/setup.html or the Setup Guide wiki page.
See CONTRIBUTING.md.
See SECURITY.md.