Skip to content

Commit 110c299

Browse files
committed
RFCs have to describe migrations
1 parent c5dc1fd commit 110c299

File tree

1 file changed

+8
-0
lines changed

1 file changed

+8
-0
lines changed

text/0000-edition-2021.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -102,6 +102,14 @@ Migrations typically come with one or more **migration lints**. Each lint warns
102102

103103
The default edition for new projects will be 2021.
104104

105+
## RFCs that propose edition changes
106+
107+
RFCs that propose migrations should include details about how the migration between editions will work. This migration should be described in sufficient detail that the relevant teams can assess the feasibility of the migration. It will often make sense to consult the compiler team on this question specificially.
108+
109+
* To perform this evaluation, an RFC proposing a migration should enumerate the situations that will no longer compile with the change.
110+
* For each such situation, it should describe how the code will be modified such that it works on both the old and new edition.
111+
* Alternatively, if that scenario is deemed unlikely, the RFC can state that this sort of code will not be automatically ported between editions. It should then describe if it is possible to at least issue a warning that the code will no longer work or will change meaning in the new edition.
112+
105113
## Tooling workflow
106114

107115
The expected workflow for upgrading to a new edition is as follows:

0 commit comments

Comments
 (0)