Skip to content

Instantly share code, notes, and snippets.

@tlebel

tlebel/design_docke_template.md

Created April 3, 2019 18:42
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save tlebel/92d9f24dec7c4807662a6589ba44e231 to your computer and use it in GitHub Desktop.
Save tlebel/92d9f24dec7c4807662a6589ba44e231 to your computer and use it in GitHub Desktop.
Download ZIP
Design Doc Template
Raw
design_docke_template.md

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