[{"data":1,"prerenderedAt":74},["ShallowReactive",2],{"term-d\u002Fdesign-doc":3,"related-d\u002Fdesign-doc":59},{"id":4,"title":5,"acronym":6,"body":7,"category":40,"description":41,"difficulty":42,"extension":43,"letter":44,"meta":45,"navigation":46,"path":47,"related":48,"seo":53,"sitemap":54,"stem":57,"subcategory":6,"__hash__":58},"terms\u002Fterms\u002Fd\u002Fdesign-doc.md","Design Doc",null,{"type":8,"value":9,"toc":33},"minimark",[10,15,19,23,26,30],[11,12,14],"h2",{"id":13},"eli5-the-vibe-check","ELI5 - The Vibe Check",[16,17,18],"p",{},"A design doc is the longer, more detailed cousin of an RFC, written after the team has basically agreed something should be built and now someone needs to actually think through how. It covers the architecture, the data flow, the tradeoffs between the approaches you considered, and the parts you're still unsure about, so the eventual reviewer of your PR isn't discovering your reasoning for the first time buried in a code comment.",[11,20,22],{"id":21},"real-talk","Real Talk",[16,24,25],{},"A design doc is a written technical proposal describing the architecture, data model, interfaces, and tradeoffs of a planned system or feature in enough detail for reviewers to evaluate the approach before implementation, distinct from an RFC in that it typically assumes the should-we-do-this question is settled and focuses on how. The practice was popularized industry wide by Google's internal design doc culture and is now standard at most engineering organizations building anything beyond a small, self-contained change.",[11,27,29],{"id":28},"when-youll-hear-this","When You'll Hear This",[16,31,32],{},"\"Skip the design doc for a one-line config change, but not for a new service.\" \u002F \"The design doc caught a scaling problem in review that would've been way more expensive to catch in production.\"",{"title":34,"searchDepth":35,"depth":35,"links":36},"",2,[37,38,39],{"id":13,"depth":35,"text":14},{"id":21,"depth":35,"text":22},{"id":28,"depth":35,"text":29},"general","A design doc is the longer, more detailed cousin of an RFC, written after the team has basically agreed something should be built and now someone needs to...","beginner","md","d",{},true,"\u002Fterms\u002Fd\u002Fdesign-doc",[49,50,51,52],"RFC","Architecture Decision Record","Code Review","Architecture",{"title":5,"description":41},{"changefreq":55,"priority":56},"weekly",0.7,"terms\u002Fd\u002Fdesign-doc","LNW2lt-MZu7YeSkooGyDxDzbebVEqcCk9eAAOuqIzuY",[60,65,68,71],{"title":52,"path":61,"acronym":6,"category":62,"difficulty":63,"description":64},"\u002Fterms\u002Fa\u002Farchitecture","architecture","intermediate","Architecture is the master blueprint for your app — like deciding whether to build a house, apartment block, or skyscraper before laying a single brick.",{"title":50,"path":66,"acronym":6,"category":40,"difficulty":63,"description":67},"\u002Fterms\u002Fa\u002Farchitecture-decision-record","An ADR documents WHY you made a technical decision, not just what you decided. Why PostgreSQL over MongoDB? Why microservices over monolith?",{"title":51,"path":69,"acronym":6,"category":40,"difficulty":42,"description":70},"\u002Fterms\u002Fc\u002Fcode-review","A code review is when another developer reads your code before it gets merged, looking for bugs, bad practices, or anything confusing.",{"title":49,"path":72,"acronym":6,"category":40,"difficulty":42,"description":73},"\u002Fterms\u002Fr\u002Frfc","An RFC, in modern engineering-culture speak, is a short document you write before you build something big, laying out the problem and your proposed solutio...",1792528078901]