File tree 2 files changed +16
-1
lines changed
2 files changed +16
-1
lines changed Original file line number Diff line number Diff line change @@ -37,6 +37,12 @@ let b = Arc::from("a");
37
37
will no longer compile, because we've previously been relying on inference to figure out the ` T ` in ` Box<T> ` .
38
38
39
39
This kind of breakage can be ok, but a [ crater] ( https://github.com/rust-lang/crater/blob/master/docs/bot-usage.md ) run should estimate the scope.
40
+ When implementing traits known to have this problem, crater should be run before initiating FCP,
41
+ so information on the scope of the breakage is available before deciding to accept the change.
42
+ This can include, but is not limited to,
43
+
44
+ - From
45
+ - FromIterator
40
46
41
47
## Deref coercion breaks when a new impl is introduced
42
48
Original file line number Diff line number Diff line change @@ -4,5 +4,14 @@ Breaking changes should be avoided when possible.
4
4
[ RFC 1105] ( https://rust-lang.github.io/rfcs/1105-api-evolution.html ) lays the foundations for what constitutes a breaking change.
5
5
Breakage may be deemed acceptable or not based on its actual impact,
6
6
which can be approximated with a [ crater] ( https://github.com/rust-lang/crater/blob/master/docs/bot-usage.md ) run.
7
+ Running crater should be done if nontrivial breakage is expected, so the information is
8
+ available during the final comment period.
7
9
8
- If the impact isn't too high, looping in maintainers of broken crates and submitting PRs to fix them can be a valid strategy.
10
+ If the impact isn't too high, looping in maintainers of to-be-broken crates and submitting PRs
11
+ to fix them can be a valid strategy. However, this can only affect the crates in question, and
12
+ it does not automatically affect their dependents. Binary dependents may have already locked-in
13
+ a different, older version.
14
+
15
+ ## Breaking and the trains
16
+ If a PR is merged and it turns out to have caused code to not compile during the nightly or beta release cycle,
17
+ unless there is a trivial fix, the PR should be reverted and a crater run should assess the impact.
You can’t perform that action at this time.
0 commit comments