51–60 of 110 posts
Lack of README files that explain the project, the audience, and provides some good examples. Libraries that change their api surface so much over time that LLMs end up producing code against deprecated versions of the library. More up front thought should be given to the api surface.
Sometimes you come upon a library and it tells you what it does but there is no explanation or context on why you would want to use it
I can't believe that in 2025 it is still hard to find documentation for basic functionality in languages as ubiquitous as, say, Python. If I google something simple I get 100 junk sites of garbage (GeeksForGeeks, W3Schools, etc), a bunch of AI-generated crap, a bunch of archaic out-of-date stuff, the official documentation which is a wall of dense text, some tutorials that mention the basics, a bunch of shitty bootca…
> I can't believe that in 2025 it is still hard to find documentation for basic functionality in languages as ubiquitous as, say, Python. That’s why we get familiar with the documentation manual and bookmark the web version. Then there’s offline documentation browsers (dash, devdocs,…). > it is amazing to me that shells still exist in more-or-less the same form Bash and ZSH are quite good for their use cases (running…
It’s a good idea to take some time to understand how the official language docs are organized so that you can just jump there straight away and bypass all the noise
I can't believe that in 2025 it is still hard to find documentation for basic functionality in languages as ubiquitous as, say, Python. If I google something simple I get 100 junk sites of garbage (GeeksForGeeks, W3Schools, etc), a bunch of AI-generated crap, a bunch of archaic out-of-date stuff, the official documentation which is a wall of dense text, some tutorials that mention the basics, a bunch of shitty bootca…
be the change you wish to see
Having used Scala and TypeScript a lot for work over the last ~5 years, I think I'm going to say static typing. It's lunacy. Computers mostly don't work in types, my brain usually doesn't work in types, and only a small subset of the problems I work on really work in types. The amount of modern languages that think they can solve everything in the type system boggles my mind.
I feel the allure of over typing most in typescript, because it is so flexible to make really complicated types. I see the mistakes most often when JS libraries move from JS to TS. They go overboard with the typing. The code becomes gibberish.
I can't believe that in 2025 it is still hard to find documentation for basic functionality in languages as ubiquitous as, say, Python. If I google something simple I get 100 junk sites of garbage (GeeksForGeeks, W3Schools, etc), a bunch of AI-generated crap, a bunch of archaic out-of-date stuff, the official documentation which is a wall of dense text, some tutorials that mention the basics, a bunch of shitty bootca…
i’ve been maining `nushell` for about 1.5 years now, and it’s basically this. a real programming language that is designed as a command runner and output parser. i have a ton of scripts that parse output from common commands like `git` and facilitate a ton of shell-based workflows: https://github.com/covercash2/dotfiles/tree/main/nuenv
The fact that most new programming services and products are oriented towards C-suite types, and not to the people who actually use them. Most websites looks like [1] or [2] which are full of corporate-friendly buzzwords but don't help me understand what they actually do or how they work. To get a concrete understanding I need to go to github and find repos that actually use the product to even understand what it's f…
Well, that's obviously because the people using the software aren't the customers. The customers are the ones signing the checks. I actually think it's the right approach for a tech business - your main landing pages should market towards the buyers and then you can have more technical documentation pages for the users. As an example from your comment: https://tailscale.com/kb/1151/what-is-tailscale
I can't believe that in 2025 it is still hard to find documentation for basic functionality in languages as ubiquitous as, say, Python. If I google something simple I get 100 junk sites of garbage (GeeksForGeeks, W3Schools, etc), a bunch of AI-generated crap, a bunch of archaic out-of-date stuff, the official documentation which is a wall of dense text, some tutorials that mention the basics, a bunch of shitty bootca…
> also it is amazing to me that shells still exist in more-or-less the same form. dear god can I just get a terminal that runs something like Python directly? There's no reason why you can't set Python to be your shell. Here you go: sudo usermod -s /usr/bin/python $USER su $USER You'll likely find that it's not that great as a shell language. Shell languages are made to be primarily used interactively. With Python, y…