2016-04-21 16:22:22 +00:00
|
|
|
- Feature Name: (fill me in with a unique ident, my_awesome_feature)
|
|
|
|
- Start Date: (fill me in with today's date, YYYY-MM-DD)
|
|
|
|
- RFC PR: (leave this empty)
|
|
|
|
- Rust Issue: (leave this empty)
|
|
|
|
|
|
|
|
# Summary
|
|
|
|
[summary]: #summary
|
|
|
|
|
|
|
|
One para explanation of the feature.
|
|
|
|
|
|
|
|
# Motivation
|
|
|
|
[motivation]: #motivation
|
|
|
|
|
|
|
|
Why are we doing this? What use cases does it support? What is the expected outcome?
|
|
|
|
|
|
|
|
# Detailed design
|
|
|
|
[design]: #detailed-design
|
|
|
|
|
|
|
|
This is the bulk of the RFC. Explain the design in enough detail for somebody familiar
|
|
|
|
with the language to understand, and for somebody familiar with the compiler to implement.
|
|
|
|
This should get into specifics and corner-cases, and include examples of how the feature is used.
|
|
|
|
|
2016-12-07 02:47:14 +00:00
|
|
|
# How We Teach This
|
|
|
|
[how-we-teach-this]: #how-we-teach-this
|
|
|
|
|
2017-06-26 23:21:05 +00:00
|
|
|
What names and terminology work best for these concepts and why?
|
2016-12-07 18:00:31 +00:00
|
|
|
How is this idea best presented—as a continuation of existing Rust patterns, or as a wholly new one?
|
2016-12-07 02:47:14 +00:00
|
|
|
|
2017-06-26 23:21:05 +00:00
|
|
|
Would the acceptance of this proposal change how Rust is taught to new users at any level?
|
2016-12-07 18:00:31 +00:00
|
|
|
How should this feature be introduced and taught to existing Rust users?
|
2016-12-07 02:47:14 +00:00
|
|
|
|
|
|
|
What additions or changes to the Rust Reference, _The Rust Programming Language_, and/or _Rust by Example_ does it entail?
|
|
|
|
|
2017-06-26 23:21:05 +00:00
|
|
|
What would an outline of a new section in the book look like? What should the reader be able to understand by the end of the section in the book?
|
|
|
|
|
|
|
|
What's an example that would show off this feature?
|
|
|
|
|
2016-04-21 16:22:22 +00:00
|
|
|
# Drawbacks
|
|
|
|
[drawbacks]: #drawbacks
|
|
|
|
|
|
|
|
Why should we *not* do this?
|
|
|
|
|
|
|
|
# Alternatives
|
|
|
|
[alternatives]: #alternatives
|
|
|
|
|
|
|
|
What other designs have been considered? What is the impact of not doing this?
|
|
|
|
|
|
|
|
# Unresolved questions
|
|
|
|
[unresolved]: #unresolved-questions
|
|
|
|
|
|
|
|
What parts of the design are still TBD?
|