Skip to content

Commit 9f8a140

Browse files
authored
Merge pull request #2734 from reddevilmidzy/eRFC
Document experimental RFC process in walkthrough
2 parents d30076c + 22282e2 commit 9f8a140

File tree

1 file changed

+14
-1
lines changed

1 file changed

+14
-1
lines changed

src/walkthrough.md

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -97,7 +97,7 @@ If that sounds like a lot of work, it's because it is.
9797
But no fear!
9898
Even if you're not a compiler hacker, you can get great feedback by doing a _pre-RFC_.
9999
This is an _informal_ discussion of the idea.
100-
The best place to do this is internals.rust-lang.org.
100+
The best place to do this is [internals.rust-lang.org](https://internals.rust-lang.org).
101101
Your post doesn't have to follow any particular structure.
102102
It doesn't even need to be a cohesive idea.
103103
Generally, you will get tons of feedback that you can integrate back to produce a good RFC.
@@ -159,6 +159,19 @@ Here is the tracking issue on for our [`?` macro feature][tracking].
159159

160160
[tracking]: https://github.com/rust-lang/rust/issues/48075
161161

162+
## Experimental RFC (eRFC)
163+
164+
An eRFC is a variant of the RFC process used for complex features where the high-level need
165+
is clear, but the design space is too large to settle on a detailed specification upfront.
166+
Instead of providing a final design, an eRFC outlines a high-level strategy to authorize
167+
a period of active experimentation. This allows the team to implement the feature behind
168+
a feature gate and gather practical data, which then informs a subsequent formal RFC for stabilization.
169+
While this process was used for major features like coroutines ([see RFC 2033][rfc2033]),
170+
the explicit "eRFC" label is rarely used today. The project now generally prefers approving a standard
171+
RFC for an initial version and iterating on it through the nightly channel before final stabilization.
172+
173+
[rfc2033]: https://github.com/rust-lang/rfcs/pull/2033#issuecomment-309057591
174+
162175
<a id="impl"></a>
163176

164177
## Implementation

0 commit comments

Comments
 (0)