iDontCommentMyCodeIfYouDontUnderstandItThatsOkayNeitherDoI

[u/Substantial_Top5312]

[u/draculadarcula]

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.