Defines a technical approach, its tradeoffs, and how the team will build and operate it. Use before implementing a system change or feature that needs shared technical decisions.
Document detailsName the proposal and list its contributors.
Background and scopeExplain the problem, the evidence that it exists, and relevant context.
Risks and concernsList unknowns that could change the approach, schedule, or outcome.
High-level design proposalDescribe the proposed solution and how it fits the existing system.
Detailed designExplain the parts of the design needed to implement and review it.
Technology choicesRecord the hosting, hardware, and client-server decisions that affect implementation.
Scalability, security, and privacyDescribe expected growth, security controls, and handling of personal information.
Rollout and transitionLay out deployment stages and any migration from the current system.
Testing and operationsExplain how the design will be checked before and during rollout, who responds to problems, and how the system recovers.