One para explanation of the proposal.
Why are we doing this? What use cases does it support? What is the expected outcome?
This is the bulk of the RFC. Explain the design in enough detail that:
- It is reasonably clear how the feature would be implemented.
- Corner cases are dissected by example.
- How the feature is used.
Why should we not do this?
- Why is this design the best in the space of possible designs?
- What other designs have been considered and what is the rationale for not choosing them?
- What is the impact of not doing this?
What parts of the design are still to be determined?