• oleorun@real.lemmy.fan
    link
    fedilink
    English
    arrow-up
    11
    ·
    9 months ago

    Reminds me of a comment I once came across in a work application’s code: “This function took forever to write correctly. It was hard work. I didn’t document it. Figure it out.”

    Of course the variables were not defined properly and were named esoterically.

    • BleatingZombie@lemmy.world
      link
      fedilink
      arrow-up
      1
      ·
      9 months ago

      the variables were not defined properly and were named esoterically

      I wonder why it was so hard and took so long to write

  • clearleaf@lemmy.world
    link
    fedilink
    arrow-up
    4
    ·
    edit-2
    9 months ago

    I don’t understand how devs can be too lazy to write documentation but somehow they’d rather explain the same shit in discord over and over and over and over and over and over

    • RoyaltyInTraining@lemmy.world
      link
      fedilink
      arrow-up
      1
      ·
      9 months ago

      The help command is one of the first things I work on in any project. Even if I’m never gonna share it, my future self will appreciate it.

  • Navigate@partizle.com
    link
    fedilink
    English
    arrow-up
    1
    ·
    edit-2
    9 months ago

    I was recently trying trying to get help on a clipboard program someone had recommended me, clipq. What I found instead was a GitHub discussion where the dev said “I’m not sure what you mean by ‘man’ pages” in response to someone asking for them. I think I need to find an alternative

  • qupada@kbin.social
    link
    fedilink
    arrow-up
    1
    ·
    9 months ago

    But also

    mysterytool --help
    mysterytool: unrecognized option: '-'

    ok then…

    mysterytool -h
    mysterytool: unrecognized option: 'h'

  • Rooty@lemmy.world
    link
    fedilink
    arrow-up
    1
    ·
    9 months ago

    If the program’s author hasn’t bothered to properly document its function, then it has no business being on my machine.