Spent much of yesterday and today writing an at length explainer of a thing I proposed last week. To me it seemed simple, to everyone else it seemed alarmingly complicated. The truth is probably in the middle, right?
So I wrote up my thinking, literal code style, with tests, and now it seems even simpler. But I absolutely found some holes in my assumptions that didn’t show up until I needed to explain them with working code. And I did get rid of some complexity, all because I explained myself.