What is this document meant to accomplish?
What’s the context of the project? What are you solving and why? What constraints informed this design?
If your proposal is implemented, how does it benefit the company?
What exactly are you trying to do? Why? These should be measurable and specific.
What are you explicitly not trying to do? Why?
Optional. What else did you consider? Why were they rejected as a solution?
At a high level, how is your service put together? What’s the block-level diagram for the service?
Another level of detail beyond the design overview, if needed.
What should we know about performance?
Are there known or potential security issues that should be pointed out? How are, or will they be, addressed?
Are there known or potential privacy or GDPR issues that should be pointed out? How are, or will they be, addressed?
What kind of logs are you generating? At what volume? How long do will we expect to keep them?
What does the rest of engineering have to do if this project is implemented?
Who has to sign off on this before it can move to implementation?