News for hackers. Stuff that matters.

A comment on Code only says what it does. Parent comment

Re:Code only says what it does by pronoiac on Monday July 06, 2020 @03:14PM (#23751598)
> "The comments are in the commit messages" - almost nobody ever goes looking for them there

Consider it another tool in the toolbox. I've gone spelunking through git history to decipher the reasoning of something still in use, though comments had been deleted and no one had documented it before me.

[ Parent | on HN ]
Re:Code only says what it does by zimpenfish on Monday July 06, 2020 @07:58PM (#23754168)
This works iff there are good commit messages. In my experience, people who don't document their code tend not to bother with good commit messages either.
[ Parent | on HN ]