659
submitted 1 week ago by [email protected] to c/[email protected]
top 50 comments
sorted by: hot top new old
[-] [email protected] 114 points 1 week ago

"Documentation is like sex: You're not getting any"

[-] [email protected] 18 points 1 week ago* (last edited 1 week ago)

Damn haha, this made me laugh out loud

[-] [email protected] 70 points 1 week ago

Someone's never read instructions autotranslated from Chinese and not checked for accuracy.

[-] [email protected] 12 points 1 week ago

Well, sometimes I ask questions to the AI and makes the same sense.

[-] [email protected] 7 points 1 week ago

Literally me yesterday trying to decipher Baidu’s PaddleOCR docs. Have half a mind to aim Claude Code at the URL and just be like ‘plz help’

[-] [email protected] 48 points 1 week ago

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

[-] [email protected] 8 points 1 week ago

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.

[-] [email protected] 6 points 1 week ago

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

[-] [email protected] 3 points 1 week ago

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

load more comments (1 replies)
[-] [email protected] 4 points 1 week ago

I can name a few examples of this

[-] [email protected] 3 points 1 week ago

That documentation sounds like marriage.

[-] [email protected] 4 points 1 week ago
load more comments (1 replies)
[-] [email protected] 41 points 1 week ago

I've had to use outdated documentation that made the problem worse. So I guess bad documentation is like bad, unprotected sex with a lot lizard that leaves you with an itching or burning sensation.

load more comments (2 replies)
[-] [email protected] 38 points 1 week ago

Completely incorrect - bad documentation can be actively harmful, wasting your time with its inaccuracies.

[-] [email protected] 34 points 1 week ago

Then you haven’t seen bad documentation (or had that sex you regret).

[-] [email protected] 3 points 1 week ago* (last edited 1 week ago)

In general it’s supposed to be something good so it shouldn’t be harmful, but ofc exceptions exist, especially with sex, sadly…

Bad often equals "not super good" in this context

[-] [email protected] 30 points 1 week ago

Incidentally, both bad sex and code documentation both involve std vectors.

load more comments (1 replies)
[-] [email protected] 28 points 1 week ago

Respectfully disagree. Sometimes the documentation is so bad that you have more questions than answers and even then, what they provide still doesn't really explain how to do something with enough details. It's all literally shot in the dark and you're just left with leap of faith. * cough * Sonicwall * cough *

[-] [email protected] 2 points 4 days ago

Last week I spent a day trying to figure out why the thing in the damn documentation doesn't work.

Turns out, for that project "latest" doesn't point to their latest release, but to what they currently have on their dev branch. And apparently they changed the whole module around since the last release.

[-] [email protected] 1 points 16 hours ago
[-] [email protected] 26 points 1 week ago
[-] [email protected] 26 points 1 week ago* (last edited 1 week ago)

This meme was made by someone who has never had truly bad sex/documentation.

[-] [email protected] 3 points 6 days ago

Yup, op has never had the joy of the docs lying to them.

[-] [email protected] 8 points 1 week ago

Is getting a face full of pussy that stinks like a litter box better than no pussy at all? 🤔

[-] [email protected] 5 points 1 week ago

Good example! My point exactly!

[-] [email protected] 25 points 1 week ago

Bad documentation could land you in prison.

Bad sex is just horrible all around.

not sure what this post is on about

[-] [email protected] 20 points 1 week ago

I would say bad sex can land you in a prison too.

[-] [email protected] 8 points 1 week ago
[-] [email protected] 18 points 1 week ago

When it's bad you think "Fuck this, I can do it better by myself."

[-] [email protected] 16 points 1 week ago

Bad sex is not better than no sex.... Wtf... :)

[-] [email protected] 3 points 1 week ago* (last edited 1 week ago)

the person who wrote this hasn't had bad sex yet

[-] [email protected] 4 points 1 week ago

I guess its also our culture where sex is seen as the most important thing in life. So everyone is convinced their entire value consists of how much mating they are doing. Maybe that would be true if we were breeding animals but we are not.

[-] [email protected] 3 points 1 week ago

It's different from person to person. The most consistent thing I've found is people trying to fit each other into a cultural box

load more comments (2 replies)
[-] [email protected] 12 points 1 week ago

As an asexual person this anology is very confusing

[-] [email protected] 1 points 4 days ago

As an asexual person, you get just as much sex as most developers get documentation.

[-] [email protected] 10 points 1 week ago

Maybe it can be translated into something else, like, "Documentation is like toilet paper, when it's good it's good, when it's bad it's better than nothing"? Or, "Documentation is like clothes, even if they are bad it's better than nothing", or "Documentation is like having something you need, it's better to have the thing you need even if is not good, than to not have the thing you need at all"?

[-] [email protected] 6 points 1 week ago

I like the analogy with toilet paper. Because when its bad, the very thing that was supposed to help you, got you covered in shit with no back out plan, making it that much worse.

Very fitting

[-] [email protected] 5 points 1 week ago

As a sexual person, I agree

load more comments (1 replies)
[-] [email protected] 8 points 1 week ago

When it’s really bad, it can be far worse than nothing.

[-] [email protected] 6 points 1 week ago

When it's bad, it's life changing in a traumatic way.

[-] [email protected] 6 points 1 week ago

What about when the sex is ... wrong?

[-] [email protected] 5 points 1 week ago

Documentation: use x function Reality: x function depreciated

[-] [email protected] 4 points 1 week ago

Don't be virgins, document things

load more comments
view more: next ›
this post was submitted on 07 Jun 2025
659 points (94.8% liked)

Programmer Humor

24173 readers
1008 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