Post

One thing I’ve changed my mind on when it comes to documentation is whether to discuss implementation details. The purist in me wanted to leave them out because “the whole point is you don’t need to know!” But in hindsight this paternalises consumers. It leaves them without a good mental model.

Josh Pullen

@pulljosh.com

My dependency minimalism has trended up over time. As a beginner, I couldn't accomplish what I wanted without the help of black-box dependencies. But the more that I can implement things myself (or at least understand the implementation), the better I feel.

8/1/25, 12:09 am0 reposts1 like

No replies yet.