A single-paragraph context-problem-solution summary
Just enough context necessary to frame the rest of the design doc.
A description of the problem that this design doc is trying to address, the constraints, and why this problem is worth solving now.
// Illustrated with example code.
Explain how this feature will be implemented. Highlight the components of your implementation, relationships between components, constraints, etc.
What are the failure scenarios you are going to cover in your testing
What new threats may be introduced?
What changes need to be made to the documentation?
How do we know if this proposal was successful?