Skip to content
Gallery
Gannon's Tech Design Document Template
[TDD Template]
Data
Share
Explore

icon picker
[TDD Template]

Use this template to guide the technical planning of a new feature.
GM
Gabriel Michels
|
GH
Gannon Hall
Replace document name with Name of addressed feature. Be clear.
Deadline:
May 6, 2020
⁠
⁠
Initiative:
Blank
⁠
⁠
Team
PM
Lead
Engineers
Document Owner
Reviewers
Status
1
[squad B]
FM
Felix Marlin
PR
Polly Rose
LT
Lola Tseudonym
MJ
Mary Jones
BD
Buck Dubois
GH
Gannon Hall
JD
Joel Davis
Discussion Closed
There are no rows in this table
⁠

Read Confirmation
⁠
I read this document
⁠
⁠
People
Created on
1
AD
Adam Davis
6/23/2020, 11:23 PM
2
BD
Buck Dubois
6/23/2020, 11:23 PM
3
GH
Gannon Hall
6/23/2020, 11:23 PM
There are no rows in this table
3
Count
⁠
⁠

Overview

A high-level summary that everyone should be able to understand. What problem are you trying to solve? Where is this problem coming from and how are you trying to solve it. Give some context so that the reader exactly know's what he or she is going to read.

Goals and Non-Goals

What do want to achieve?
Why are we doing this?
What are we not addressing?
What might have been expected but is not covered?

Technical Solution

This is the main part of the document. This can contain multiple designs i.e. data-model design, architecture design, UI-design, procedural design.
Current Solution
Proposed Solution
Alternative Solution
Tradeoffs

Think about answering these questions (at this stage, involve relevant stakeholders in Systems & Data - currently Max VB & Kartik):
What systems and components will be affected?
Which API's need to be created or changed?
How will this be tested?
Which other topics are to be considered? Logging, Analytics, Localisation, Error-Handling?
What are potentially the contentious parts of this proposal that need to be discussed?
Does your solution involves introducing new data points (New Dynamo Db, ???)?
Does your solution involve changing the schema of a data source (Dynamo Db Table, ???)?

Effort

This section will be of interest especially when people outside of engineering are involved and need to be able to plan accordingly.
How long will this project take overall?
How long will it's broken-down tasks take for whom?

Thoughts and Open Questions

Add anything going through your mind or any open questions you might have that need to be discussed with other people.
Want to print your doc?
This is not the way.
Try clicking the ⋯ next to your doc name or using a keyboard shortcut (
CtrlP
) instead.