News for hackers. Stuff that matters.
Re:Software engineers should write by JoeAltmaier on Monday December 29, 2014 @04:06PM (#8811770)
This a hundred times. Comments should always be about intent; never about what's actually happening (the mechanistic description). I don't need help understanding the code as read; I need to know WHY the code was written. So I can debug, follow code paths, skim.

A further advantage: such comments have longer halflives. A rewritten method may still have the same purpose long after all details are changed.

There are no comments on this comment yet.