teaching · python

Notebook etiquette that keeps hybrid cohorts readable

Chi Lam · 2026-01-19

Open notebook with handwriting beside printed bar chart handout

Hybrid analytics classes die by a thousand untitled cells. We require a top cell with session intent, data sources, and known caveats—even if it feels redundant for veterans.

We also ban silent magic numbers in presentation mode: if a threshold appears twice, it becomes a named constant with a one-line rationale. Reviewers skim faster, and mentors can grep for regressions.

For async peers, we ask for a “pause point” cell every twenty minutes of estimated work: a checkpoint question that forces a human decision before continuing. It is slower upfront, but cuts rework when someone joins three days late.

We keep appendices short on the blog; if you need primary sources or query snippets referenced in class, ask via the contact desk with the module name in the subject line.