Skip to content

How segments work

Each segment (one part of the day) has the same predictable structure, so you always know where you are and how to catch up.

What every segment page contains

SectionWhat it gives you
At a glanceThe start state, end state, and fallback baseline for the part.
Learning goalsWhat you'll be able to do afterward.
Why it mattersThe motivation, tied to the Dunder Mifflin story.
What you will buildThe concrete artifact for the part.
Knowledge-share outlineThe short intro talk.
Lab stepsCopy-paste friendly steps, each with expected output.
CheckpointA quick check that you reached the end state.
Fallback baselineThe known-good version to switch to if needed.
TroubleshootingCommon problems and fixes.
Optional stretch taskExtra depth for advanced attendees.
What we will not coverThe scope boundary for the part.

The rhythm

Every part: a short knowledge-share first, then hands-on work, ending at a checkpoint. If your hands-on attempt doesn't finish, switch to the fallback baseline and you'll start the next part in the right place.

The segments

Authoring a new segment?

Start from snippets/segment-skeleton.md, which encodes the required structure above.