teaching · python
Notebook etiquette that keeps hybrid cohorts readable
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.