Design Docs at Google
One of the key elements of Google's software engineering culture is the use of design docs for defining software designs. These are relatively informal documents that the primary author or authors of a software system or application create before they embark on the coding project. The design doc documents the high level implementation strategy and key design decisions with emphasis on the trade-offs that were considered during those decisions. As software engineers our job is not to produce code per se, but rather to solve problems. Unstructured text, like in the form of a design doc, may be the better tool for solving problems early in a project lifecycle, as it may be more concise and easier to comprehend, and communicates the problems and solutions at a higher level than code. Besides the original documentation of a software design, design docs fulfill the following functions in the software development lifecycle: Early identification of design issues when making changes is still ch
One of the key elements of Google's software engineering culture is the use of design docs for defining software designs. These are relatively informal documents that the primary author or authors of a software system or application create before they embark on the coding project. The design doc documents the high level implementation strategy and key design decisions with emphasis on the trade-offs that were considered during those decisions. As software engineers our job is not to produce code per se, but rather to solve problems. Unstructured text, like in the form of a design doc, may be t
Explore this link on the map →saved by
related reading
- How Stripe creates the best documentation in the industrymintlify.com
- Introductionthird-bit.com
- Karl Koch | Write-first designkarlkoch.me
- Writing a good design documentgrantslatton.com
- AddyOsmani.com - 21 Lessons From 14 Years at Googleaddyosmani.com
- The Gulf Between Design and Engineering / Design Systems Internationaldesignsystems.international
- How Stripe Built a Writing Culture - Knock Down Silos by Slabslab.com
- Wonder Blocks: on the creation of Khan Academy’s design systemdesignsystems.com
- Software Architecture is Overrated, Clear and Simple Design is Underrated - The Pragmatic Engineerblog.pragmaticengineer.com
- Software Engineering at Googleabseil.io
- GitHub - google-labs-code/design.md: A format specification for describing a visual identity to coding agents. DESIGN.md gives agents a persistent, structured understanding of a design system. · GitHubgithub.com
- Designing Systems | Atomic Design by Brad Frostatomicdesign.bradfrost.com