Skip to content

Commit 9d8fdaa

Browse files
committed
Unstable features: clarify that the Rust language is stable
A LWN discussion [1] seemed to indicate that it is unclear that the Rust language is stable. Thus clarify further this point, including a couple links to the stability promise in Rust 1.0 as well as The Rust Edition Guide. Link: https://lwn.net/Articles/944201/ [1] Signed-off-by: Miguel Ojeda <[email protected]>
1 parent 7377030 commit 9d8fdaa

File tree

1 file changed

+3
-1
lines changed

1 file changed

+3
-1
lines changed

src/Unstable-features.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,9 @@
22

33
## Introduction
44

5-
The kernel uses some Rust unstable features. These features can only be accessed by opting into them. They are typically used as a way to introduce new features into the language, library and toolchain to allow end users to experiment with them and provide feedback before committing to them.
5+
The Rust language is stable, i.e. it promises [backwards compatibility](https://blog.rust-lang.org/2014/10/30/Stability.html) within the same [edition](https://doc.rust-lang.org/edition-guide/editions/), with a few exceptions, such as reserving the right to patch safety holes. The kernel currently uses Edition 2021, which is the latest.
6+
7+
On top of that, the kernel uses some Rust unstable features. These features can only be accessed by opting into them. They are typically used as a way to introduce new features into the language, library and toolchain to allow end users to experiment with them and provide feedback before committing to them.
68

79
"Unstable" in this context means the feature may change in future versions, i.e. backwards compatibility is not promised for those features. It does not necessarily imply that the features are broken.
810

0 commit comments

Comments
 (0)