this post was submitted on 07 Jun 2025
600 points (95.3% liked)

Programmer Humor

23855 readers
1177 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
[–] Console_Modder@sh.itjust.works 47 points 22 hours ago (4 children)

Absolutely not. I'd rather have no documentation and start from scratch than be gaslit by an entire team of people telling me that the very obviously wrong documentation is correct and has been correct for 30 years

[–] agamemnonymous@sh.itjust.works 7 points 19 hours ago (1 children)

I think there's a difference between bad and wrong. Wrong documentation is incorrect. Bad documentation isn't really incorrect, it's just poorly executedb and mostly unhelpful.

[–] docAvid@midwest.social 5 points 19 hours ago (1 children)

I mean, incorrect documentation is clearly bad, so...

[–] agamemnonymous@sh.itjust.works 3 points 18 hours ago (1 children)

Seemed more like the problem was the gaslighting than the documentation.

[–] kkj@lemmy.dbzer0.com 1 points 13 hours ago

Wrong documentation is still a pretty big problem, even without the gaslighting. Incomplete documentation is better than none; incorrect documentation is not.

[–] Boomkop3@reddthat.com 4 points 15 hours ago

I can name a few examples of this

[–] Phoenix3875@lemmy.world 3 points 18 hours ago (1 children)

That documentation sounds like marriage.

[–] Boomkop3@reddthat.com 4 points 15 hours ago
[–] entropicdrift@lemmy.sdf.org 1 points 21 hours ago

Well also like sex, when it's really bad it's worse than nothing.