• Oliver Lowe@apubtest2.srcbeat.com
    link
    fedilink
    arrow-up
    2
    ·
    6 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.

    • lysdexic@programming.devOP
      link
      fedilink
      English
      arrow-up
      1
      ·
      edit-2
      6 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.