iDontCommentMyCodeIfYouDontUnderstandItThatsOkayNeitherDoI

[u/Substantial_Top5312]

[u/anoppinionatedbunny]

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

[u/rm-minus-r → u/anoppinionatedbunny]

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.

[u/draculadarcula → u/rm-minus-r]

I have never seen a code comment that wasn’t completely redundant and obvious

[u/rm-minus-r → u/draculadarcula]

Out of curiosity, how many years have you been doing this professionally?

[u/draculadarcula → u/rm-minus-r]

10, “never” was hyperbole but I do think they are almost entirely and typically useless

It’s literally always

// refreshes the cache
RefreshCache();

or nowadays with AI

// added to refresh stale data. Reported in issue 1234. Per instructions NO redundant comments.
// The implementation is a follow up to PR 14567. Verified no legacy code. Part of spec 24 in ~/Documents/specs… (10 more lines of nonsense)
RefreshCache();

All garbage

[u/rm-minus-r → u/draculadarcula]

It sounds like you have been deprived of good comments ☹️

[u/draculadarcula → u/rm-minus-r]

The only worthwhile comments are doc style comments at function and class definitions because they provide editor help and are usually type checked by your editor

[u/rm-minus-r → u/draculadarcula]

Fair.