Programmer Humor

19145 readers

1480 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

Keep content in english
No advertisements
Posts must be related to programming or programmer topics

founded 1 year ago

MODERATORS

Feyter@programming.dev

anzo@programming.dev

BurningTurtle@programming.dev

698

Bill is a pro grammer (sh.itjust.works)

submitted 9 months ago by CowsLookLikeMaps@sh.itjust.works to c/programmer_humor@programming.dev

99 comments fedilink hide all child comments

you are viewing a single comment's thread
view the rest of the comments

[–] heikomat@lemmy.world 16 points 9 months ago* (last edited 9 months ago) (1 children)

Exactly that! Everyone can See "what" is happening, the code is right there. But the code usually doesn't tell you "why" that is happening - good comments help understand the authors intent and give context, so you don't have to guess.

Good comments should explain the things that are not obvious.

Good comments more than once prevented me from accidentially undoing a fix.

[–] nilloc@discuss.tchncs.de 2 points 9 months ago* (last edited 9 months ago)

Yup my comments are generally along the lines of:

I could have done this X way, but it ran slower
I was running out of time so this it’s mostly copied from (stack overflow url)
refactor when time allows

This is a side effect of doing lots of tiny websites , microcontroller code and mini web apps for under budgeted marketing projects with constantly changing designs and requirements that don’t need to last too long.