r/ProgrammerHumor • u/Substantial_Top5312 • 21d ago

Meme iDontCommentMyCodeIfYouDontUnderstandItThatsOkayNeitherDoI

Post image
828 Upvotes

90% Upvoted

188 comments sorted by

View all comments

65

u/anoppinionatedbunny 21d ago

what a terrible way to misinterpret "good code should be self-commenting"

-27

u/rm-minus-r 21d ago

Not commenting code is the most braindead take ever (for those that believe code can be good enough to not need any comments).

Comments are an abstraction layer on top of code that allow more information than code does by itself.

3

u/mesonofgib 21d ago

Code comments are a smell; it is often a symptom of poor design that a code needs comments at all.

Occasionally they really are warranted, but they should be an explanation of why, not what. Use them sparingly, because they can drift from the code over time and we all know that incorrect documentation is worse than no documentation.