Skip to content

Instantly share code, notes, and snippets.

@ooh-data-dave
Created May 28, 2019 05:06
Show Gist options
  • Select an option

  • Save ooh-data-dave/68e4f4a9d6eeaebf83f68eb82b714cbf to your computer and use it in GitHub Desktop.

Select an option

Save ooh-data-dave/68e4f4a9d6eeaebf83f68eb82b714cbf 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.

@ooh-data-dave
Copy link
Author

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