https://patrickdesjardins.com/blog
7 posts · 5 Votes
Tech 86% · Life 14%
Subscribe via RSS
A few months ago, I and within a few weeks I was taking page after page of notes using . I initially liked it, but I missed taking notes with a pen. Something about scribbling, annotating, and illustrating my thoughts helps me focus and retain better than copy-pasting or typing. When I was doing my…
The web was built for humans using a browser. APIs were built for developers who read documentation. Both scenarios never anticipate autonomous agents that must reason about what to do next. As LLM agents increasingly interact with services, a question emerges that few people are addressing directly…
I will argue that generating documentation with AI is useful, specifically the kind that lives as dedicated documentation files in folders alongside the code, and specifically for business logic and architecture. My thesis is that this documentation is valuable because it serves humans and AI agents…
I wrote in , , , and about TypeScript and private functions. Eleven years later, I still believe that relaxing encapsulation to ease testability has the best return on investment (ROI). In this blog post I will argue that separating classes and interfaces preserves a portion of the encapsulation wh…
I recently visited and noticed a simple idea that I liked: comments do not need to live inside the website database. They can live on the social web, and the website can point to the discussion. For a static website, this is appealing because I do not want to run a comment server, to moderate a loc…
I recently moved this website away from NextJS as the static generation engine. The site was working, but it had become heavier than what I needed. Most pages are static. Most content is markdown. The build was doing a lot of framework work for a problem that had become much smaller than the framewo…
I built an audiobook machine for my daughter in January 2022 using a Raspberry Pi and RFID cards (). In early 2026, I built a second version for my son using an ESP32 and a TFT display (). Over time, I wanted to replace my daughter's original device because the RFID cards became cumbersome whenever…
