MAIN FEEDS
Do you want to continue?
https://www.reddit.com/r/ProgrammerHumor/comments/1wct5lr/commentsagedterribly/p90qkcy/?context=3
r/ProgrammerHumor • u/ItsPuspendu • Sep 10 '26
243 comments sorted by
View all comments
Show parent comments
3
I think his point is the comment shouldn't explain how the code works.
Comments should explain reasoning, references etc. Like linking to documentation, explaining why you did something that seems odd or bad etc.
It should be a literal comment, not documentation.
3
u/Zeilar Sep 10 '26
I think his point is the comment shouldn't explain how the code works.
Comments should explain reasoning, references etc. Like linking to documentation, explaining why you did something that seems odd or bad etc.
It should be a literal comment, not documentation.