News for hackers. Stuff that matters.

A comment on The Art of Code Comments. Parent comment

Re:The Art of Code Comments by inertiatic on Friday November 03, 2017 @11:05PM (#15623582)
Thinking code can be "self-documenting" is one of the biggest delusions of this field.
[ Parent | on HN ]
Re:The Art of Code Comments by abritinthebay on Saturday November 04, 2017 @01:03AM (#15623885)
You’re being downvoted but it’s extremely true.

Code should strive to be as self-documenting as possible but there will always need to be some level of documentation- and good comments are part of that.

One other part of that effort should be good unit, integration, and acceptance, tests.

[ Parent | on HN ]