Skip to content

Instantly share code, notes, and snippets.

@mahigupta
Forked from polotek/design_docke_template.md
Created April 12, 2021 19:57
Show Gist options
  • Save mahigupta/55b2b260d413977eebba19fd4a3a1956 to your computer and use it in GitHub Desktop.
Save mahigupta/55b2b260d413977eebba19fd4a3a1956 to your computer and use it in GitHub Desktop.
Design Doc Template

Design Doc Title

Stakeholders

List stakeholders for project/feature.

Role Person
Dev Owner
Other Dev 1 (Engine)
Other Dev 2 (Hub)
Product
Docs
QA
Program Management
UX

Problem Statement

Describe what you are trying to solve. Reference JIRAs etc. as needed.

Goals

List goals you are planning on achieving with the project/feature.

  1. Goal 1
  2. Goal 2
  3. Goal 3

Non-Goals

List anything that should be called out explicitly as a non-goal (i.e., things that would not be addressed with this project/feature). This section is optional and can be left blank.

Design

One-pager of the design and implementation plan. Can be high level and does not need to call out explicit functional code, though it is up to the owner on how deep they want to go.

API

What API endpoints will be exposed to the user as part of this feature?

Dependencies

List any external component and/or cross functional dependencies.

Testing

Functional Testing

Plan for functional testing (automated, non-automated, etc).

Performance Testing

Plan for performance testing (automated, non-automated, etc) if needed.

Scale Testing

Plan for scale testing (automated, non-automated, etc) if needed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment