A Philosophy of Software Design

by John Ousterhout

if a bug fix requires the addition of code whose purpose isn’t totally obvious, add a comment describing why the code is needed.