The Power of Technical Storytelling

When I explain a technical change, I start with what prompted it. A person trying to do something and running into a problem is easier to follow than an opening tour of the architecture.

Then I can explain the choices and their consequences. I don't need to make every decision sound dramatic. An honest account of a small improvement is more useful than a polished story that leaves out all the constraints.