This meme was made by someone who has never had truly bad sex/documentation.
Yup, op has never had the joy of the docs lying to them.
Someone’s never read instructions autotranslated from Chinese and not checked for accuracy.
“Documentation is like sex: You’re not getting any”
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.
I mean, incorrect documentation is clearly bad, so…
When it’s really bad, it can be far worse than nothing.
Incidentally, both bad sex and code documentation both involve std vectors.
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.
🙏
