A Philosophy of Software Design

by John Ousterhout

if it takes a long comment to fully describe a variable, it’s a red flag that suggests you may not have chosen the right variable decomposition.