A design doc is a promise
A design doc is a promise you make to your future self about which arguments you will not have again.
Everything else — the diagrams, the risks section, the alternatives — is scaffolding. The load is on that one promise.
Engineering · 2020← Margins