1220
More the merrier (lemmy.world)
you are viewing a single comment's thread
view the rest of the comments
[-] Drop_All_Users@lemmy.world 55 points 1 year ago

Code documentation is like sex, when it's good it's great, and when it's not good...it's still better then no documentation.

[-] zesty@lemmy.ca 18 points 1 year ago

I disagree. When comments are essentially just a rephrasing of the class/method name or arguments it is not helpful and anything that is not helpful is cluttering up the code and making it harder to quickly see what the code is doing. I'd rather have no comments than comments like that.

[-] farsightxr20@lemmy.world 5 points 1 year ago

Not to mention the code and comment will inevitably become inconsistent with each other whenever someone forgets to update both.

load more comments (4 replies)
load more comments (14 replies)
this post was submitted on 20 Aug 2023
1220 points (99.0% liked)

Programmer Humor

19197 readers
1374 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 1 year ago
MODERATORS