Context

The reasoning, written down

The decisions, specs and plans behind event-hog, kept next to the code so anyone can check why it works the way it does. Open questions are left open on purpose: they're where review is most useful.