this post was submitted on 26 Nov 2023
706 points (89.2% liked)

Programmer Humor

25734 readers
1237 users here now

Welcome to Programmer Humor!

This is a place where you can post jokes, memes, humor, etc. related to programming!

For sharing awful code theres also Programming Horror.

Rules

founded 2 years ago
MODERATORS
 
you are viewing a single comment's thread
view the rest of the comments
[–] [email protected] 119 points 2 years ago (44 children)
[–] [email protected] 12 points 2 years ago (43 children)

Yeah, but unironic...

If your code needs comments, it's either because it's unnecessarily complex/convoluted, or because there's more thought in it (e.g. complex mathematic operations, or edge-cases etc.). Comments just often don't age well IME, and when people are "forced" to read the (hopefully readable) code, they will more likely understand what is really happening, and the relevant design decisions.

Good video I really recommend: https://www.youtube.com/watch?v=Bf7vDBBOBUA

[–] [email protected] 5 points 2 years ago* (last edited 2 years ago) (7 children)

and if you need an unnecessarily complex code for performance sake?

[–] [email protected] 14 points 2 years ago (1 children)

There's a comment for you to explain the why.

Rule of thumb: code explains the how and what, comments explain the why.

[–] [email protected] 3 points 2 years ago

Yeah that's a good summary

load more comments (5 replies)
load more comments (40 replies)
load more comments (40 replies)