The minimum useful README

When a system surprises me, my first instinct used to be to fix the surprise. Now my first instinct is to figure out which mental model of mine was wrong, and update that.

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.

If a config file has more than a dozen options, half of them aren't being used. The other half are being used in ways the original author didn't predict.