News for hackers. Stuff that matters.

A comment on Software engineers should write. Parent comment

Re:Software engineers should write by gaius on Monday December 29, 2014 @02:01PM (#8811190)
The code doesn't document your intent. There's no way to tell if something weird is a bug, or a feature for an edge case that was never written down.
[ Parent | on HN ]
Re:Software engineers should write by lmm on Monday December 29, 2014 @03:05PM (#8811520)
Variable and method names can do that, and are more likely to be kept up to date than comments.
[ Parent | on HN ]