Overview

Purpose: After Step 2 (Think & Discuss), trainees submit quick reflections (~2–3 min, mostly taps).

End of workshop: one final survey (module ratings + overall + open feedback).

Format (v2.0): Multiple choice + checkboxes + linear scales — minimal typing (name only).

Source of truth for questions: google-forms-manifest.yaml

Note

Trainer grading: google-forms-reflection-answer-key.md (best options + why)

Based on: reflection-prompts.md · module-delivery-pattern.md

Why multiple choice first

BenefitDetail
Faster for trainees~2–3 min per form vs 5+ min for paragraphs
Easier in SheetsFilter/count wrong answers; spot class misconceptions
Still sparks discussionWrong options are deliberate distractors — debrief in pairs

Trade-off: Less nuance than open text. Keep whiteboard for 3–5 bullets; Form checks understanding.

Question type mix (per module)

TypeUse for
Multiple choiceSingle best answer
CheckboxesSelect all that apply / pick two
Linear scale (1–5)Module-specific clarity / fit / readiness (not a global confidence poll)
Multiple choice gridModule 7 tool comparison
Short answerName only (global G1)

No paragraph questions in per-module reflections. Exception: final survey has one optional open-text field.

Final workshop survey (`module: final`)

When: Last session or closing (after Mod 7, or after optional Mod 8–9 if delivered).

Time: ~5 minutes · Not tied to Think & Discuss.

IDTypeContent
G1Short answerName (global)
F.1Grid 1–5Rate Mod 0–9 (skip 8–9 if not attended)
F.2Scale 1–5Overall workshop rating
F.3Scale 1–5How much you took away
F.4Multiple choiceWould you recommend to a colleague?
F.5Multiple choiceWorkshop pace (too fast / about right / too slow)
F.6ParagraphOpen suggestions (optional)

Facilitator: Say once — *"Skip optional module rows if you didn't attend that track."* Link to Sheets for cohort averages.

powershellnode create-forms.mjs --module final

Deployment

OptionDescription
A — One form per module (recommended)QR after each section; ~2–3 min each
B — Single journey formPage break per module
C — Module 7 onlyDecision matrix only
Final surveyOne form at end (module: final in manifest)

Automation (create-forms.mjs)

FeatureDetail
Quiz modeMod 0–9: quiz_mode: true + google-forms-grading.yaml
Final surveyNormal form — no auto-score
Bannerbanner_image in manifest; optional banner_source_uri
Drive folderdrive_folderdriveFolder.folderUrl in forms-output.json
Trainer answer keygoogle-forms-reflection-answer-key.md via node sync-grading-artifacts.mjs

Google Forms UI: Settings → Quizzes → release grades Immediately after each submission.

CommandPurpose
node create-forms.mjs --replaceDelete old forms from output JSON, recreate
node create-forms.mjs --organize-folderMove existing forms into drive_folder only
node sync-grading-artifacts.mjsRefresh answer-key.md after grading YAML edits

Questions per module (summary)

ModForm title (Google Form)QuestionsMostly
0Welcome & Setup7 + nameMC + pick-two checkbox
1Data Engineering Fundamentals7MC
2Databricks Pipeline6 + scaleMC + checkbox + scale
3Snowflake Pipeline6 + scaleMC + scale
4dbt Pipeline7 + scaleMC + checkbox + scale
5Production Patterns7 + scaleMC + checkbox + scale
6AI Features7 + scaleMC + checkbox + scale
7Power BI Payoff & Tool Discussion10 + gridsMC + checkbox + 3 grids + scale
8Streaming Data Processing (optional)6MC
9Machine Learning (optional)7MC + checkbox
Final6 + name + gridPer-module grid + overall + takeaway + recommend + pace + open text

Full wording and options: google-forms-manifest.yaml

API, GCP, manual build

See google-forms-gcp-setup-guide.md and README.md.

powershellcd workshop-2026-v2/trainer/google-forms
npm install
node create-forms.mjs --dry-run
node create-forms.mjs --replace

Note: A plain node create-forms.mjs creates duplicate forms. Prefer --replace after manifest or grading changes. --delete-only removes forms in forms-output.json without recreating.

Document history

DateChange
2026-05-31Initial design (mixed paragraph + MC)
2026-05-31v2.0 — multiple-choice first; manifest is source of truth
2026-05-31Final survey — module grid + overall + takeaway + open suggestions
2026-05-31Quiz mode + google-forms-grading.yaml + auto-score via create-forms.mjs
2026-05-31Docs: Drive folder, script commands, organize-folder