(Feel free to change headings here, remove sections that are not relevant, or add other sections)
Describe what problem is being solved here, and (briefly) how this proposal solves it.
Describe the logical data model that your proposal adds.
Describe how the data will be persisted.
Describe the methods that the API will expose. If there are any breaking changes be sure to call them out here.
Is there a front-end component to this work?
Here is where you can go into detail about implementation details like data structures, algorithms, etc.
What are the security implications of this proposal? How are API requests authenticated? Who can make API calls?
Does this feature relate to any spec?
What are the downsides to this implementation? What other alternatives were considered?
If there's any references or prior art, put that here.