• Oliver Lowe
    link
    fedilink
    27 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]OP
      link
      fedilink
      English
      1
      edit-2
      7 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]
    link
    fedilink
    -37 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?