|
| 1 | +- Feature Name: (fill me in with a unique ident, my_awesome_feature) |
| 2 | +- Start Date: (fill me in with today's date, YYYY-MM-DD) |
| 3 | +- RFC PR: (leave this empty) |
| 4 | +- Rust Issue: (leave this empty) |
| 5 | + |
| 6 | +# Summary |
| 7 | +[summary]: #summary |
| 8 | + |
| 9 | +One para explanation of the feature. |
| 10 | + |
| 11 | +# Motivation |
| 12 | +[motivation]: #motivation |
| 13 | + |
| 14 | +Why are we doing this? What use cases does it support? What is the expected outcome? |
| 15 | + |
| 16 | +# Detailed design |
| 17 | +[design]: #detailed-design |
| 18 | + |
| 19 | +This is the bulk of the RFC. Explain the design in enough detail for somebody familiar |
| 20 | +with the language to understand, and for somebody familiar with the compiler to implement. |
| 21 | +This should get into specifics and corner-cases, and include examples of how the feature is used. |
| 22 | + |
| 23 | +# How We Teach This |
| 24 | +[how-we-teach-this]: #how-we-teach-this |
| 25 | + |
| 26 | +What names and terminology work best for these concepts and why? |
| 27 | +How is this idea best presented—as a continuation of existing Rust patterns, or as a wholly new one? |
| 28 | + |
| 29 | +Would the acceptance of this proposal change how Rust is taught to new users at any level? |
| 30 | +How should this feature be introduced and taught to existing Rust users? |
| 31 | + |
| 32 | +What additions or changes to the Rust Reference, _The Rust Programming Language_, and/or _Rust by Example_ does it entail? |
| 33 | + |
| 34 | +# Drawbacks |
| 35 | +[drawbacks]: #drawbacks |
| 36 | + |
| 37 | +Why should we *not* do this? |
| 38 | + |
| 39 | +# Alternatives |
| 40 | +[alternatives]: #alternatives |
| 41 | + |
| 42 | +What other designs have been considered? What is the impact of not doing this? |
| 43 | + |
| 44 | +# Unresolved questions |
| 45 | +[unresolved]: #unresolved-questions |
| 46 | + |
| 47 | +What parts of the design are still TBD? |
0 commit comments