“Documentation is like sex: You’re not getting any”
Damn haha, this made me laugh out loud
Someone’s never read instructions autotranslated from Chinese and not checked for accuracy.
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’
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 *
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
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.
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
no.
Bad documentation could land you in prison.
Bad sex is just horrible all around.
not sure what this post is on about
When it’s bad you think “Fuck this, I can do it better by myself.”
Bad sex is not better than no sex… Wtf… :)
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.
As an asexual person this anology is very confusing
As a sexual person, I agree
Documentation: use x function Reality: x function depreciated
What about rape? Is that just chatgpt reworded documentation?
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