📔 Introduction

In this section make a clear statement about what this document is about, to allow the reviewer to know if it's a relevant document.

⛈️ Problem Statement

In this section, explain succinctly the problem you want to fix.

🔬 Scope

In this section make sure to mention what you want to deal with, and explicitly what you do not what to deal with.

⚙️ Technical Details

In this section, go deep into why the problem occurs, what is the technical or organizational context and what’s going to happen next.

This section is meant to give enough details for the reviewer to understand the proposals enough to make an informed guess or comment.

🔘 Options

Any good decision starts by laying out options. In this section, write what you consider the options ahead of you, and make a recommendation with the “strong opinions, loosely held” philosophy.

The goal of this section is to help reviewers propose new options and do a sanity check on the decision.

Option 1: Re-write Author's recommendation

Option 2: Use a Vendor

🛣️ Plan

In this section explain how you would go about implementing or executing your plan.