Design Docs are a common tool that [[Software engineering MOC|Software engineering]] teams use to build software faster, by clarifying assumptions and circulating plans earlier. ## #OpenQuestions - When should you write a design doc and when is it overkill? - Should design docs be treated as just a guideline for initial decisions and first implementation, or should it be kept up to date with any changes which resulted during implementation or future iterations? --- ## References - [Software Engineering RFC and Design Doc Templates](https://blog.pragmaticengineer.com/rfcs-and-design-docs/) by [[Gergely Orosz]]. Lists of templates used at many big engineering companies - [Design Docs at Google](https://www.industrialempathy.com/posts/design-docs-at-google/)