Technical design doc template
The sections a design review needs, and none it does not.
- Stage
- Plan
- Sections
- 7
- Updated
How to fill it in
- 1Say what exists today, and why it no longer fits.
- 2Describe the approach, then the data.
- 3Compare at least two alternatives.
- 4Plan the rollout and the rollback.

Context
What exists today, and why it no longer fits.
Approach
The design in a few sentences, then the detail below.
Data model
Alternatives considered
Option A
Why not.
Option B
Why not.
Trade-offs we are accepting
Rollout
Open questions
What’s inside 7
- Context
- Approach
- Data model
- Alternatives considered
- Trade-offs we are accepting
- Rollout
- Open questions
Where to find it
In Kanso, add a page and pick this template, or type / in any doc.
Read the guide: How to write a technical design doc
Questions
A document written before significant engineering work that explains how it will be built, which alternatives were considered and what trade-offs are accepted.
More templates
All templatesUse the technical design in Kanso.
Free does not expire. No card required.


