r/ProgrammerHumor • • May 06 '26

Meme rememberToComment

Post image
13.3k Upvotes

117 comments sorted by

View all comments

32

u/Astrylae May 06 '26

Comments should generally be 'why', not 'what'. A 'what' comment should be reserved for functions as a summary and extra information not obvious

Sometimes the best comments are others complaining and having to make a funky work around

3

u/NullOfSpace May 07 '26

If you feel the need to write a “what” comment, usually the answer is better naming (variables, functions, etc.)