top 50 comments

sorted by: hot top controversial new old
[–] 141 points 2 years ago (4 children)

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.

  • source
  • hideshow 7 child comments
  • [–] 109 points 2 years ago (1 child)

    the variables were not defined properly and were named esoterically

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

  • source
  • parent
  • hideshow 2 child comments
  • load more comments (1 reply)
    [–] 136 points 2 years ago (2 children)
    $ mysterytool
    $
    

    WHAT DID YOU DO?!

  • source
  • hideshow 4 child comments
  • [–] 100 points 2 years ago* (last edited 2 years ago) (7 children)

    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

  • source
  • hideshow 12 child comments
  • load more comments (2 replies)
    [–] 83 points 2 years ago* (12 children)

    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

  • source
  • hideshow 14 child comments
  • load more comments (10 replies)
    [–] 64 points 2 years ago* (2 children)

    Haha, I made this :) Here’s the blog post I created it for, if you want a bit of context:

    https://www.tweag.io/blog/2023-10-05-cli-ux-in-topiary/

  • source
  • hideshow 2 child comments
  • load more comments (2 replies)
    [–] 49 points 2 years ago (2 children)

    But also

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

    ok then...

    mysterytool -h
    mysterytool: unrecognized option: 'h'

  • source
  • hideshow 4 child comments
  • [–] 42 points 2 years ago (7 children)

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

  • source
  • hideshow 8 child comments
  • load more comments (6 replies)
    [–] 32 points 2 years ago (2 children)
  • load more comments (1 reply)
    [–] 32 points 2 years ago* (10 children)

    Programmers generally detest to do documentation, so when the user help "UI" is all down to a programmer to define this is often what you get, especially if it's a small tool.

  • source
  • hideshow 12 child comments
  • Yeah this is shitty, and if you're a programmer reading this and you agree with it, be better. There is no excuse for under-documenting a CLI.

    Even when I'm developing, I write out my usage text first, like -o [json,csv,pretty] specify output format (default 'pretty') [NOT IMPLEMENTED] or the like.

  • source
  • parent
  • load more comments (8 replies)
    [–] 32 points 2 years ago

    It's like people don't like surprises anymore.

  • source
  • [–] 27 points 2 years ago

    Exclusively installed through some dodgy PPA you got from a blog.

  • source
  • [–] 25 points 2 years ago*

    strings `which mysterytool` | less

    Give up your darn secrets before I start fumbling around with strace and get even more frustrated!

  • source
  • [–] 22 points 2 years ago

    I just want to say this is a masterful use of the format.

  • source
  • [–] 14 points 2 years ago (1 child)
  • [–] 10 points 2 years ago
    [+] 10 points 2 years ago* (last edited 1 year ago) (3 children)
  • load more comments (2 replies)
    [–] 9 points 2 years ago

    python -V

    What the actual fuck

  • source
  • [+] 9 points 2 years ago* (last edited 2 years ago) (3 children)
    load more comments (3 replies)
    load more comments
    view more: next β€Ί