• I Deleted 70,000 Comments

    On 18 August I deleted every comment in a 29-day-old codebase: 71,660 lines across 742 files. Agents wrote most of them, and agents believed all of them. Here is where the reasons live now, what broke, and how the comments came back.

    , · 4 min
  • Always Be Cap Deploying (ABCD)

    A fast startup cannot live on maintenance windows. My team deploys several times a day and can fix, change, and break production in minutes. It takes decoupled services, many tests, and serious code review.

    · 1 min
  • Modules are not for Readability

    A module is for shared code. If you move methods into one only because the class got long, you add indirection and confuse everyone.

    · 1 min
  • Code Like It Is For A Blog

    People have to read your code, whether it works or not. Write it as if the whole world will review it, with comments open.

    · 1 min

New essays in your inbox

Every essay arrives by email the morning it goes up here. Full text, no paywall.