- Authors:
- Created: (date)
- PR: (link to pull request)
(The tl;dr. Concise statement of the reason for the document and recommendation.)
(List of tenets, values, guiding principles that are used to evaluate the proposal.)
(Clearly explain the problem.)
(Optional: are there any special considerations for testing required?)
(What security risks might exist for the recommendation? Can we reduce them? What should users consider when using it?)
(List alternatives considered, and especially why they were not recommended. This portion of "documenting the why" helps Future Us to see if anything has changed since last considered.)