Code Quality
-
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.
-
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.
Software Craft · 1 min -
Simplification
I track time across six projects with one tool: the stopwatch on my phone. Simpler tools, fewer features, and smaller products are harder up front. They pay back over the long run.
Engineering Leadership · 3 min -
Fix It Later
“Fix it later” is what is wrong with your software project. Doing the hard, tedious work now is the job. It is why people trust a senior developer to lead.
Software Craft · 2 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.
Software Craft · 1 min