Differentiate logging a bit, so that the really spammy stuff can be disabled whilst leaving other stuff on.
Revise main comment detailing the design.