671

will document for sex (feddit.org)

submitted 4 weeks ago by NichEherVielleicht@feddit.org to c/programmer_humor@programming.dev

66 comments fedilink hide all child comments

top 50 comments

sorted by: hot top controversial new old

[-] umbraroze@piefed.social 119 points 4 weeks ago

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

[-] FireIced@lemmy.super.ynh.fr 18 points 4 weeks ago* (last edited 4 weeks ago)

Damn haha, this made me laugh out loud

[-] db2@lemmy.world 71 points 4 weeks ago

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

[-] kubica@fedia.io 11 points 4 weeks ago

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

[-] lemon@sh.itjust.works 7 points 4 weeks 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’

[-] Console_Modder@sh.itjust.works 52 points 4 weeks 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

[-] agamemnonymous@sh.itjust.works 9 points 4 weeks 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.

[-] docAvid@midwest.social 6 points 4 weeks ago

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

[-] agamemnonymous@sh.itjust.works 3 points 4 weeks ago

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

load more comments (1 replies)

[-] Boomkop3@reddthat.com 4 points 4 weeks ago

I can name a few examples of this

[-] Phoenix3875@lemmy.world 3 points 4 weeks ago

That documentation sounds like marriage.

[-] Boomkop3@reddthat.com 4 points 4 weeks ago

You ok?

load more comments (1 replies)

[-] spooky2092@lemmy.blahaj.zone 43 points 4 weeks 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.

[-] flambonkscious@sh.itjust.works 3 points 4 weeks ago

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!)

load more comments (1 replies)

[-] GissaMittJobb@lemmy.ml 39 points 4 weeks ago

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

[-] magic_lobster_party@fedia.io 35 points 4 weeks ago

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

[-] FireIced@lemmy.super.ynh.fr 3 points 4 weeks ago* (last edited 4 weeks 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

[-] savvywolf@pawb.social 31 points 4 weeks ago

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

load more comments (1 replies)

[-] LovableSidekick@lemmy.world 30 points 4 weeks ago* (last edited 4 weeks ago)

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

[-] Kolanaki@pawb.social 8 points 4 weeks ago

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

[-] LovableSidekick@lemmy.world 5 points 4 weeks ago

Good example! My point exactly!

[-] mostlikelyaperson@lemmy.world 5 points 3 weeks ago

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

[-] thatradomguy@lemmy.world 29 points 4 weeks 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 *

load more comments (2 replies)

[-] 5714@lemmy.dbzer0.com 26 points 4 weeks ago

no.

[-] Owlboi@lemm.ee 24 points 4 weeks ago

Bad documentation could land you in prison.

Bad sex is just horrible all around.

not sure what this post is on about

[-] general_kitten@sopuli.xyz 20 points 4 weeks ago

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

[-] Owlboi@lemm.ee 8 points 4 weeks ago

good point

[-] Godnroc@lemmy.world 19 points 4 weeks ago

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

[-] 1984@lemmy.today 16 points 4 weeks ago

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

[-] stebo02@sopuli.xyz 3 points 4 weeks ago* (last edited 4 weeks ago)

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

[-] 1984@lemmy.today 5 points 4 weeks 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.

[-] stebo02@sopuli.xyz 3 points 4 weeks ago

weird, i do not know of this culture and I'm glad cuz I'd be worthless

[-] Boomkop3@reddthat.com 3 points 4 weeks 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 (1 replies)

[-] gerryflap@feddit.nl 12 points 4 weeks ago

As an asexual person this anology is very confusing

[-] pmk@lemmy.sdf.org 10 points 4 weeks 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"?

[-] Jiggs@lemmy.dbzer0.com 6 points 4 weeks 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

[-] ColdSideOfYourPillow@piefed.social 5 points 4 weeks ago

As a sexual person, I agree

load more comments (2 replies)

[-] BlameTheAntifa@lemmy.world 9 points 4 weeks ago

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

[-] jerkface@lemmy.ca 6 points 4 weeks ago

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

[-] wetbeardhairs@lemmy.dbzer0.com 6 points 4 weeks ago

What about when the sex is ... wrong?

[-] einlander@lemmy.world 5 points 4 weeks ago

Documentation: use x function Reality: x function depreciated

[-] And009@lemmynsfw.com 4 points 4 weeks ago

Don't be virgins, document things

[-] Korhaka@sopuli.xyz 3 points 4 weeks ago

When documentation is missing critical bits of information I don't know if its better than nothing. Spend ages and then have to raise a ticket saying its a bug because its not working as documented, when no documentation would have just been an instant ticket raised asking how its supposed to work. Because it turns out everything was working correctly and the customer had just set something up wrong but there was no documentation covering that bit so according to what we had, all looked good.

load more comments