News for hackers. Stuff that matters.
Re:Avoid Else, Return Early (2013) by gruez on Monday March 26, 2018 @11:14AM (#16679496)
>No, I do a git blame, and see all the relevant commit messages.

sounds great until there's a refactor (including moving code around), then all the "comments" get buried.

Re:Avoid Else, Return Early (2013) by macintux on Monday March 26, 2018 @11:35AM (#16679639)
It's a bit humorous that often the same people who insist the code should be enough documentation follow that up by clarifying that git, of course, supplies the rest.

So something entirely outside the codebase, which may or may not be available to the person who needs the information, and which may or may not need to be extensively searched through years of history to find the relevant commit message, which may or may not be sufficient to explain the code... is better than having a comment in the code.