• db2@lemmy.world
    link
    fedilink
    arrow-up
    69
    ·
    6 days ago

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

  • spooky2092@lemmy.blahaj.zone
    link
    fedilink
    arrow-up
    42
    ·
    6 days 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.

  • Console_Modder@sh.itjust.works
    link
    fedilink
    arrow-up
    50
    ·
    6 days 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

  • GissaMittJobb@lemmy.ml
    link
    fedilink
    arrow-up
    39
    ·
    6 days ago

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

  • thatradomguy@lemmy.world
    link
    fedilink
    arrow-up
    29
    ·
    6 days 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 *

    • squaresinger@lemmy.world
      link
      fedilink
      arrow-up
      1
      ·
      3 days ago

      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.

    • FireIced@lemmy.super.ynh.fr
      link
      fedilink
      arrow-up
      3
      ·
      edit-2
      6 days 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

  • Owl@lemm.ee
    link
    fedilink
    English
    arrow-up
    26
    arrow-down
    2
    ·
    6 days ago

    Bad documentation could land you in prison.

    Bad sex is just horrible all around.

    not sure what this post is on about

  • 1984
    link
    fedilink
    arrow-up
    17
    arrow-down
    1
    ·
    6 days ago

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

      • 1984
        link
        fedilink
        arrow-up
        6
        arrow-down
        1
        ·
        6 days 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.

    • pmk@lemmy.sdf.org
      link
      fedilink
      arrow-up
      10
      ·
      6 days 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
        link
        fedilink
        arrow-up
        6
        ·
        6 days 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

    • andioop@programming.dev
      link
      fedilink
      English
      arrow-up
      2
      ·
      edit-2
      5 days ago

      Also asexual.

      Just consider most people really like sex, and some experience it as a very intense physical want to the point it makes sense that a bad version of it is better than none at all. Sort of similar to food. Better to have bad-tasting food and at least sate your hunger than to have nothing and starve.

      Although, of course, it breaks down. The comments talk about actively harmful sex people wouldn’t want as well as harmful documentation; bad sex and documentation is not actually always better than no sex or no documentation. In the analogy, this would be sex that gives you an STD, or documentation that sends you running in circles and misleads you.

      I’ve found a lot of understanding sex comes with just understanding a lot of people really really want it and experience it as a nigh-on need. Maybe liken it to some intense desires you have, things you need to be happy that you nonetheless don’t need to survive. (Of course, this is a generalization, I understand not all people with sexual desires have them this intensely. Some don’t need it to be happy but would sure like it a lot. And some might even get it more mildly. But for the purpose of understanding more mainstream jokes, analogies, etc. about sex…)