There are few habits on a high-quality, fast-shipping software team that are more important than one: writing good technical design docs. Give me a few minutes and I’ll tell you about the many benefits, and how to get started. Why write design docs? While there are many benefits to writing a design doc, my personal north star goes something like this: Make sure we’re building the right thing, and before it gets expensive to do something else.