Trainer Guides

Facilitator-only — not shown to trainees during labs

TRAINER ONLY

These pages support delivery of the YellowLine NYC masterclass. Trainees use modules and exercises; trainers use the guides below.

ImportantWho signs in where
Surface Sign-in
Trainer pages (/trainer/*) Facilitator password — TRAINER_API_SECRET on Cloudflare (not published here)
Main site (Cloudflare) Workshop token + roster email → unlocks My Workshop, check-in, and section content per cohort
Vercel mirror (optional) Workshop token only — module content preview; no roster, My Workshop, or check-in

Roster trainers (00_* IDs) can also sign in on the main site with token + email. That bypasses section locks and opens My Workshop with a View workshop as roster switcher. Trainer tools on /trainer/* still require the facilitator password each browser session.

Pre-class checklist

Start here Pre-class checklist Technical platform prep — ADLS2, Databricks, Snowflake, portal, T-60 smoke tests.

Dependency map Platform dependency order Why ADLS2 → Databricks → Snowflake → Aiven — links into checklist steps. Sign-off Dry-run checklist End-to-end rehearsal before delivery day. Module 7 Power BI setup Trainee optional install · trainer Desktop build in checklist § Power BI (page 7). Production Training site Live trainee-facing site — verify before class opens.

Cohort management

Roster & portal Trainer & Trainee management Workshop session, roster, cohort credentials, and My Workshop portal link.

Attendee comms Trainee pre-work Site URL, token, GitHub invites, email templates, pre-class expectations. Check-in Workshop Check-in Management Open/close check-in, view roster status, export CSV, sign-in.html?cohort=… If check-in fails Check-in fallback runbook Google Form backup, URLs, trainee script, reconcile after class.

Day-of delivery

Start here Facilitator guide Day-of runbook — room prep, schedule, module rhythm, Module 7, fixes, close. Every module Module delivery pattern Five-step cheat sheet + timing card for modules 0–7. Think & Discuss Reflection prompts Oral discussion questions and trainer answer keys per module. Whiteboard Whiteboard prompts Story worksheet + Module 7 synthesis templates. Module 7 Open discussion guide Capstone — trainee-led tool comparison (30 min block). Module 7 Architecture decision matrix Print one handout per trainee for silent write. Media Animation fallback Live narration scripts when mod-XX MP4 is unavailable. Trainees Masterclass modules Jump to trainee-facing module content during delivery.

Quiz

Live URLs Google Form links Responder + edit links per module and final survey. Trainer only Quiz answer key MC answers + rationale for every module quiz.

Development

Site troubleshooting — not needed for day-of delivery.

Debug D1 database debug Read-only dump of all D1 tables — roster, secrets, attendance, checklist progress. API API health D1 binding and schema check via /api/trainer-db-health.

Day-of rhythm

Every main-day module (0–7):

  1. Animation (2–4 min) — media/modules/mod-XX-*.mp4 (or animation fallback)
  2. Think & Discuss (5–12 min) — informal oral discussion using reflection prompts (trainer answer keys per module); no written capture
  3. Theory (10–20 min) — module page §3
  4. Quiz (2–3 min) — Google Form (multiple choice, auto-scored)
  5. Practice — exercises or Module 7 open discussion

Cost Performance Compliance

Closing line (Module 7): Technology is a decision. Architecture is responsibility.