RFC NNNN — Title
Summary
One paragraph. What’s changing, why now.
Motivation
Why does the current state hurt? Who’s affected? Link to issues, customer reports, prior discussion.
Proposal
Concrete. What gets built / changed / removed. APIs, schemas, UI flows. Code snippets welcome.
Alternatives considered
What else did you look at? Why not those?
Drawbacks
Honest list of what gets worse.
Migration plan
If this is breaking: how do existing users get to the new state? Deprecation timeline.
Open questions
Things you genuinely don’t know yet and want input on.
Related
- Issue links
- Prior RFCs
- External references