Every story and comment from the Hacker News API, in a layout borrowed from 2001.
A comment on Ask HN: Why Did Python Win?. Parent comment
sum = sum_two_numbers(number1, number2)
Probably doesn't need a comment.
The other argument is that comments need to be maintained and are subject to decay. E.g. the code they are commenting on changes.
The book goes into other examples but i think the idea isn't to eliminate comments but to be thoughtful and judicious in which you use
There are no comments on this comment yet.
sum = sum_two_numbers(number1, number2)
Probably doesn't need a comment.
The other argument is that comments need to be maintained and are subject to decay. E.g. the code they are commenting on changes.
The book goes into other examples but i think the idea isn't to eliminate comments but to be thoughtful and judicious in which you use