When it’s really bad, it can be far worse than nothing.
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 *
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.
“Documentation is like sex: You’re not getting any”
Damn haha, this made me laugh out loud
Documentation: use x function Reality: x function depreciated
Don’t be virgins, document things
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
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.
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
weird, i do not know of this culture and I’m glad cuz I’d be worthless
deleted by creator
Deal, I’ve got plenty of small hobby projects that can use some!
There’s this cool program called qalc. I stumble on to cool features in it that’s not even listed in the documentation.
Bro has never been at /moma
What about when the sex is … wrong?
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
That documentation sounds like marriage.
You ok?
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 mean, incorrect documentation is clearly bad, so…
Seemed more like the problem was the gaslighting than the documentation.
Wrong documentation is still a pretty big problem, even without the gaslighting. Incomplete documentation is better than none; incorrect documentation is not.
I can name a few examples of this
Well also like sex, when it’s really bad it’s worse than nothing.
Completely incorrect - bad documentation can be actively harmful, wasting your time with its inaccuracies.
Incidentally, both bad sex and code documentation both involve std vectors.
It’s fine, babe, the doctor said I’ve got a standard.
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.
deleted by creator
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!)
