The minimum useful README
Sara K. · Feb 5
I split a 4000-line file into 12 smaller ones this week. The smaller files weren't actually easier to understand. The 4000-line file was a problem of structure, not of length.
I write smaller commits than I used to. The commits are uglier in isolation and much easier to read in sequence.
Latency budgets work better than latency targets. Targets are aspirational. Budgets force you to delete features when you go over.
I keep a small log of decisions in a text file. Not architectural — just small ones. "Picked X over Y because Z." Future me reads it more than I thought he would.
← back to index