Author here. Happy to take any feedback about this post.
I learned to write design docs at Microsoft and Google, and I thought they both had good culture around docs that hasn't percolated out as well as other engineering practices at those orgs. I haven't seen a thorough explanation of how to write design docs, so this is my attempt to externalize what I've learned about writing them.
0gs 23 minutes ago [-]
it would not be "fun" to financially penalize my coworkers for their mistakes, no.
bithammerthunde 16 minutes ago [-]
Not what he meant, but for an outsider it could be hilarious to watch the company tumble because of that rule.
Rendered at 14:55:54 GMT+0000 (Coordinated Universal Time) with Vercel.
I learned to write design docs at Microsoft and Google, and I thought they both had good culture around docs that hasn't percolated out as well as other engineering practices at those orgs. I haven't seen a thorough explanation of how to write design docs, so this is my attempt to externalize what I've learned about writing them.