- Feature Name: (fill me in with a unique ident,
my_awesome_feature)
One paragraph explanation of the proposal.
Why are we doing this? What use cases does it support? What is the expected outcome?
Explain the proposal as if it was already accepted and you were teaching it to another person. That generally means:
- Introducing new named concepts.
- Explaining the feature largely in terms of examples.
- If applicable, provide sample error messages, deprecation warnings, or migration guidance.
- If applicable, explain how to use this enhancement.
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?