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.
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 *
Deal, I’ve got plenty of small hobby projects that can use some!
Incidentally, both bad sex and code documentation both involve std vectors.
Bad documentation could land you in prison.
Bad sex is just horrible all around.
not sure what this post is on about
I would say bad sex can land you in a prison too.
good point
What if the documentation is wrong?
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.
Then you haven’t seen bad documentation (or had that sex you regret).
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
“Documentation is like sex: You’re not getting any”
Damn haha, this made me laugh out loud
As an asexual person this anology is very confusing
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”?
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
As a sexual person, I agree
What about rape? Is that just chatgpt reworded documentation?
Oh dang, how long until some company just feeds their entire codebase into an llm and calls it documentation?
When something like python tries to force readability into your code without your consent?
That’s why I always use a nonsensical class structure with stupid names; it’s my chastity belt.
Completely incorrect - bad documentation can be actively harmful, wasting your time with its inaccuracies.
There’s this cool program called qalc. I stumble on to cool features in it that’s not even listed in the documentation.
Don’t be virgins, document things
Bad sex is not better than no sex… Wtf… :)
the person who wrote this hasn’t had bad sex yet
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.
weird, i do not know of this culture and I’m glad cuz I’d be worthless
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
