Readit News logoReadit News
michaelsalim commented on We revamped our docs for AI-driven development   docs.freestyle.sh/blog/do... · Posted by u/benswerd
jameshart · a month ago
I love that now that computers are starting to pay attention to documentation, all of a sudden content design, documentation pruning, discoverability and indexing become things companies care about.

Nobody ever gave this much thought to their API documentation until they started turning it into MCP tools.

michaelsalim · 25 days ago
I've noticed this recently. Libraries that normally wouldn't have much documentation now has quite a long README.

I thought it was a blessing until I start reading them and realize that many of them are clearly generated by AI... The information is not wrong, but most of the time it's too long and a pain to read. Human written documentation are typically better at picking and choosing relevant information rather than dumping every single little thing

michaelsalim commented on I know when you're vibe coding   alexkondov.com/i-know-whe... · Posted by u/thunderbong
nosianu · a month ago
> most of these things can happen for poorly documented large codebase.

Documentation does not help beyond a point. Nobody reads the documentation repeatedly, which would be needed.

When you keep working on a project, and you need a new function, you would need to check or remember every single time that such a function already exists or might exist somewhere. You may have found it when you read the docs months ago, but since you had no need for that function at the time your brain just dismissed it and tossed that knowledge out.

For example, I had a well-documented utils/ folder with just a few useful modules, but they kept getting reimplemented by various programmers. I did not fault them, they would have had to remember every single time they needed some utility to first check that folder. All while keeping up that diligence forever, and while working on a number of projects. It is just too hard. Most of the time you would not find what you need, so most of the time that extra check would be a waste. Even the most diligent person would at some point reimplement something that already exists, no matter how well-documented it is. It's about that extra search step itself.

The closer you want 100% perfection you get exponentially increasing effort. So we have some duplication, not a big deal. Overall architectural quality is more important than squeezing out those last not really important few percent of perfection.

michaelsalim · a month ago
I for one think that this discipline is what separates a good developer from being a good engineer. This kind of rigorous process is the kind of thing that I'd expect from most devs but is sadly missing most of the time.
michaelsalim commented on Fast   catherinejue.com/fast... · Posted by u/gaplong
tomrod · a month ago
I'm consistently seeing personal and shared anecdotes of a 40%-60% speedup on targeted senior work.

As much as I like agents, I am not convinced the human using them can sit back and get lazy quite yet!

michaelsalim · a month ago
Curious, what do you count as senior work?
michaelsalim commented on Run TypeScript code without worrying about configuration   tsx.is/... · Posted by u/nailer
michaelsalim · a month ago
Does anyone use this in production? I tried it and it was great. But I stopped using it since I assume there'll be quite a performance hit compared to a traditional build, then running with node.
michaelsalim commented on Async Queue – One of my favorite programming interview questions   davidgomes.com/async-queu... · Posted by u/davidgomes
jonchurch_ · 2 months ago
Maybe I came into this article knowing too much about the solution, but I dont agree with commenters saying this is a poorly designed interview question. Its a blog post as well, not the format that would be presented to a candidate.

I think it has clear requirements and opportunities for nudges from the interviewer without invalidating the assessment (when someone inevitably gets tunnel vision on one particular requirement). It has plenty of ways for an interviewee to demonstrate their knowledge and solve the problem in different ways.

Ive run debounce interview questions that attempt to exercise similar competency from candidates, with layering on of requirements time allowing (leading/trailing edge, cancel, etc) and this queue form honestly feels closer to what Id expect devs to actually have built in their day to day.

michaelsalim · 2 months ago
Same here. I thought that this specific problem is not that uncommon. On top of my mind: say if the endpoint you're hitting is rate-limited. It doesn't even have to be an API call. I think I've probably written something with the same pattern once or twice before.

I do agree that this is quite javascript specific though.

michaelsalim commented on How I program with agents   crawshaw.io/blog/programm... · Posted by u/bumbledraven
verifex · 3 months ago
Some of my favorite things to use AI for when coding (I swear I wrote this not AI!):

- CSS: I don't like working with CSS on any website ever, and all of the kludges added on-top of it don't make it any more fun. AI makes it a little fun since it can remember all the CSS hacks so I don't have to spend an hour figuring out how to center some element on the page. Even if it doesn't get it right the first time, it still takes less time than me struggling with it to center some div in a complex Wordpress or other nightmare site.

- Unit Tests: Assuming the embedded code in the AI isn't too outdated (caveat: sometimes it is, and that invalidates this one sometimes). Farming out unit tests to AI is a fun little exercise.

- Summarizing a commit: It's not bad at summarizing, at least an initial draft.

- Very small first-year-software-engineering-exercise-type tasks.

michaelsalim · 2 months ago
I get the temptation to use it for CSS too. But whenever I do, it produces a bunch of debts that are annoying to spot. Sure it looks nice visually, but you need to review it even more so than normal code.
michaelsalim commented on Learn touch typing – it's worth it   typequicker.com/blog/lear... · Posted by u/absoluteunit1
michaelsalim · 3 months ago
What taught me to touch type was moving to a split keyboard. Using my old method was slow since my hands naturally wanted to press the keys on the other side. So I was basically "forced" to learn it.

Now it's second nature and I can't imagine how I did it before. I'm not too concerned about speed since I was plenty fast previously. I think I'm maybe 10% faster. But the difference in comfort is night and day.

michaelsalim commented on Human coders are still better than LLMs   antirez.com/news/153... · Posted by u/longwave
marcosdumay · 3 months ago
Hum... I imagine LLMs are better than every developer on getting CSS keywords right like the GP pointed. And I expect every LLM to be slightly worse than most classical autocompletes.
michaelsalim · 3 months ago
This is like saying that LLMs are better at knowing the name of that one obscure API. It's not wrong, but it's also not the hard part about CSS
michaelsalim commented on Someone at YouTube needs glasses   jayd.ml/2025/04/30/someon... · Posted by u/jaydenmilne
rozab · 4 months ago
For a long time the grid of videos on the homepage has been slightly misaligned. I imagine the different rows belong to different teams. This means you can't hover your mouse in the gaps between columns while you scroll to prevent videos autoplaying when moused over.

I find the autoplay so annoying because it hides the thumbnail which was carefully designed to communicate why I should click on the video and replaces it with, usually, a talking head or stock footage. Often the video gets inexplicably added to my watch history, and if I do choose to click on it I have to go back to the beginning because I missed the start of the audio

michaelsalim · 4 months ago
I thought i was the only one! I did realize at some point that you can avoid it if you hover on the left or right of the main grid. Still very annoying though
michaelsalim commented on Open source and self hostable/private file converter   vert.sh... · Posted by u/sandybonks
maxloh · 5 months ago
That isn't what they stated in their website.

> Video uploads to a server for processing by default, learn how to set it up locally here.

The server code is open source too: https://github.com/VERT-sh/vertd

michaelsalim · 5 months ago
If you follow the link on the sentence you quoted, the reason why is explained there

u/michaelsalim

KarmaCake day446February 3, 2022
About
Working on: https://dbschemalibrary.com and https://theopenpresenter.com About me: https://michaelsalim.co.uk Contact: hi@michaelsalim.co.uk

Let's chat: https://calendly.com/michael-salim/30min

View Original