News for hackers. Stuff that matters.
Re:Why Not Comments by kristiandupont on Wednesday September 11, 2024 @01:53AM (#41508393)
Not the comments I write.

I don't write what the code does or even what "I understand the code to do". I explain choices, especially ones that the next developer or my future self is likely to misunderstand when looking at the code.

Re:Why Not Comments by readthenotes1 on Thursday September 12, 2024 @09:25AM (#41520672)
But what about a year later when someone's changed the code but not the comment?
Re:Why Not Comments by kristiandupont on Thursday September 12, 2024 @12:58PM (#41522963)
I would say that I have observed something like this about as many times as someone has changed some semantics in a way that a variable or function name is no longer correct. That is to say: probably a few times in 25 years, but nothing compared to how much value I have received from them.