• @sbv@sh.itjust.works
    link
    fedilink
    English
    522 days ago

    I love shitting on Python, but I feel like all those problems are present in libraries for other languages as well. There’s a tonne of that crap for JS/TS.

    Similarly, I find a fair number of Rust crates (that I want to use) have virtually no doc or inline examples, and use weird metaprogramming that I can’t wrap my head around.

    • The Bard in GreenA
      link
      fedilink
      English
      452 days ago

      Are we living in a world in which the JS/TS ecosystem is the yardstick by which we measure well written code? I mean… Wait a minute! I figured it out! This is the Bad Place!

    • @Pacmanlives@lemmy.world
      link
      fedilink
      92 days ago

      You should look at some old Perl or C code. I have even seen some shell code that makes me want to bash my head in till death with an IBM Model M Keyboard

    • Ephera
      link
      fedilink
      202 days ago

      I mean, if we’re talking about all those problems, the no-type-annotations issue is rather specific for Python, JS/TS and Ruby.

      But in general, I feel like there’s somewhat of an old world vs. new world divide, which happened when package registries started accepting libraries from everyone and their cat.

      In C, for example, most libraries you’ll use will be quite well-documented, but you’ll also never hear of the library that Greg’s cat started writing for the niche thing that you’re trying to do.

      Unfortunately, Greg’s cat got distracted by a ball of yarn rolling by and then that was more fun than writing documentation.
      That’s the tradeoff, you get access to more libraries, but you just can’t expect all of them to be extremely high-quality…

    • Preston Maness ☭
      link
      fedilink
      English
      42 days ago

      Similarly, I find a fair number of Rust crates (that I want to use) have virtually no doc or inline examples, and use weird metaprogramming that I can’t wrap my head around.

      Is it really a true rust crate if it doesn’t contain at least one inscrutable macro?