Skip to content

Commit 390acef

Browse files
committed
Add a caution note about unstable editions possibly not being complete.
1 parent 5c379a0 commit 390acef

File tree

1 file changed

+6
-0
lines changed

1 file changed

+6
-0
lines changed

src/editions/transitioning-an-existing-project-to-a-new-edition.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -96,7 +96,13 @@ The steps are roughly similar to the stable channel:
9696
3. Edit `Cargo.toml` and place `cargo-features = ["edition2024"]` at the top (above `[package]`), and change the edition field to say `edition = "2024"`.
9797
4. Run `cargo +nightly check` to verify it now works in the new edition.
9898

99+
> **⚠ Caution**: Features implemented in the next edition may not have automatic migrations implemented with `cargo fix`, and the features themselves may not be finished.
100+
> When possible, this guide should contain information about which features are implemented
101+
> on nightly along with more information about their status.
102+
> A few months before the edition is stabilized, all of the new features should be fully implemented, and the [Rust Blog] will announce a call for testing.
103+
99104
[`cargo fix`]: ../../cargo/commands/cargo-fix.html
100105
[`cargo test`]: ../../cargo/commands/cargo-test.html
101106
[Advanced migration strategies]: advanced-migrations.md
102107
[nightly channel]: ../../book/appendix-07-nightly-rust.html
108+
[Rust Blog]: https://blog.rust-lang.org/

0 commit comments

Comments
 (0)