An open-source guide to help you write better command-line programs, taking traditional UNIX principles and updating them for the modern day.
  • Oliver Lowe
    2•5 months ago

    The Philosophy section has quite a few wonky arguments; I’d skip it altogether.

    Guidelines is pretty succinct and has many rules-of-thumb that almost any software would benefit from. That’s including CLI, GUI, libraries – even hardware if you take a bit of a step back.

    • @[email protected]OPEnglish
      1•5 months ago

      The Philosophy section has quite a few wonky arguments; I’d skip it altogether.

      I agree. I wish they moved that to a standalone section so that it could be easily skipable. Reference docs can and should have a rationale, but a lengthy rant is not what leads people to the site.

  • @[email protected]
    -3•5 months ago

    That’s way too much text. It’s an interesting topic but I can’t imagine anyone is going to read that essay. Can’t it be condensed down to a few simple examples?