News for hackers. Stuff that matters.
Re:Code should be the one version of the truth, don’t add co... by never_jello on Thursday March 05, 2020 @07:10PM (#22499823)
The author really misses the point. The best comments document not what the code does, but rather why the code was written. Comments should answer questions like "What is the intent when writing the code? What problem is the code trying to solve?" Often when the original author is long gone, it is comments like these that make managing the code so much easier.
Re:Code should be the one version of the truth, don’t add co... by downerending on Thursday March 05, 2020 @05:53PM (#22499229)
Most comments do not simply restate what is obvious from the code. (Those that do should indeed be omitted.) They rather add valuable context and other sorts of information that would be difficult or impossible to work out just from the code.

Uncommented code is usually a horror to work with.