Skip to content

PLAN.md

Latest commit

 

History

History
82 lines (61 loc) · 3.54 KB

PLAN.md

File metadata and controls

82 lines (61 loc) · 3.54 KB
Raw

PLAN — 30h Course Reframe with 8 Reflections + Oral Presentation

Goal

Reframe the 10-module course into an assessable arc:

  • Modules 1–8: each produces a branch + REFLECTION.md (submitted before the next lesson)
  • Modules 9–10: covered in the oral presentation at the end
  • Boilerplate provided for technically heavy parts — students focus on decisions, not syntax

Assessment Structure

Checkpoint Format Submitted
Module 1 branch module-01/team-name + REFLECTION.md before Module 2 lesson
Module 2 branch module-02/team-name + REFLECTION.md before Module 3 lesson
Module 3 branch module-03/team-name + REFLECTION.md before Module 4 lesson
Module 4 branch module-04/team-name + REFLECTION.md before Module 5 lesson
Module 5 branch module-05/team-name + REFLECTION.md before Module 6 lesson
Module 6 branch module-06/team-name + REFLECTION.md before Module 7 lesson
Module 7 branch module-07/team-name + REFLECTION.md before Module 8 lesson
Module 8 branch module-08/team-name + REFLECTION.md before final session
Final Oral presentation (15 min/group) last session

Reflection Template (same structure every module)

Each REFLECTION.md contains:

  1. The "why" — Why does this module's concept exist in this architecture?
  2. Your choice — One decision made (by you or the boilerplate). Explain it to someone who wasn't in the room.
  3. The tradeoff — What does this approach cost? What would you do differently?

Questions are module-specific but the format never changes. Students get familiar with the format by module 2 — no overhead.

Oral Presentation Scope

15 minutes per group, structured as:

  1. Walk the system map: what each service does and why it exists (3 min)
  2. Pick any 2 reflection answers from your branches and defend them (5 min)
  3. Modules 9–10: observability and resilience — what would you monitor, what would you protect (5 min)
  4. Q&A (2 min)

No slides required. Whiteboard or live demo acceptable.

Steps

Phase 1 — Reflection templates (modules 1–8)

  • Step 1: Create modules/module-01/REFLECTION.md
  • Step 2: Create modules/module-02/REFLECTION.md
  • Step 3: Create modules/module-03/REFLECTION.md
  • Step 4: Create modules/module-04/REFLECTION.md
  • Step 5: Create modules/module-05/REFLECTION.md
  • Step 6: Create modules/module-06/REFLECTION.md
  • Step 7: Create modules/module-07/REFLECTION.md
  • Step 8: Create modules/module-08/REFLECTION.md

Phase 2 — Oral presentation guide

  • Step 9: Create modules/module-09-10/ORAL_PRESENTATION.md with scope and preparation hints

Phase 3 — Exercise simplification (one per module)

Each exercise.md is trimmed to:

  • A clear objective (1 paragraph)

  • What boilerplate is provided and where to find it

  • What the student must actually write/decide themselves

  • The "stop here" marker — minimum to submit the branch

  • Step 10: Simplify modules/module-01/exercise.md

  • Step 11: Simplify modules/module-02/exercise.md

  • Step 12: Simplify modules/module-03/exercise.md

  • Step 13: Simplify modules/module-04/exercise.md

  • Step 14: Simplify modules/module-05/exercise.md

  • Step 15: Simplify modules/module-06/exercise.md

  • Step 16: Simplify modules/module-07/exercise.md

  • Step 17: Simplify modules/module-08/exercise.md

Phase 4 — Supporting files

  • Step 18: Update README.md to reflect the 30h structure and branch submission instructions