Post

An unintuitive thing about design docs: a doc that is clearly written but wrong on the substance is better than a doc that is hard to read but flawless on the substance. Design docs are communication tools to align humans. You can win at design but fail at design docs.

If I come across a crisp, five-page design doc that has two major flaws in its underlying assumptions, I can identify them in a 10 minute read and we can have the needed discussion. If I have to review a 35-page AI-generated treatise, I'm going to miss important details.