Programmer Humor

Damn haha, this made me laugh out loud

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

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

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

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’

I've been there... (In a work/corporate context, at least)

I'll leave 'the night work' out of it, however (damn, the glitter gets everywhere!)

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.

I can name a few examples of this

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.

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

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

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

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

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"?

As a sexual person, I agree

Also asexual.

Just consider most people really like sex, and some experience it as a very intense physical want to the point it makes sense that a bad version of it is better than none at all. Sort of similar to food. Better to have bad-tasting food and at least sate your hunger than to have nothing and starve.

Although, of course, it breaks down. The comments talk about actively harmful sex people wouldn't want as well as harmful documentation; bad sex and documentation is not actually always better than no sex or no documentation. In the analogy, this would be sex that gives you an STD, or documentation that sends you running in circles and misleads you.

I've found a lot of understanding sex comes with just understanding a lot of people really really want it and experience it as a nigh-on need. Maybe liken it to some intense desires you have, things you need to be happy that you nonetheless don't need to survive. (Of course, this is a generalization, I understand not all people with sexual desires have them this intensely. Some don't need it to be happy but would sure like it a lot. And some might even get it more mildly. But for the purpose of understanding more mainstream jokes, analogies, etc. about sex…)