Design Docs at Google
Design docs are one of my favourite things about software engineering. If code is the bricks and mortar, then these docs are the blueprints.I know this is fairly controversial, but our jobs isn't just to write code. Navigating organisations and achieving consensus between a lot of teams/technologies is a huge part of it.Design docs are a way to get all of that out of the way _before_ writing thousands of lines of code. The review process nets significantly different feedback to code reviews too.