As a design reviewer, I think all design authors should internalize this concept: > But a good doc will lay out the problem and mental models in a way that the

As a design reviewer, I think all design authors should internalize this concept: > But a good doc will lay out the problem and mental models in a way that the solution that took weeks of hard thought to invent will be clear to the reader by the time the doc presents it. Perhaps my favorite quote is: "If I had more time, I would have written a shorter letter." Design docs should make complex things simple. They should not be a dumping ground for all the intellectual hardships and false starts the engineer went through. It may still worth capturing this, but that should be in another doc, or at least an appendix. Keep the path forward simple and understandable.