Docs: Make explicit that the experimental-module-builds is unstable

CC #9329

Author: ogoffart

api/rs/build/Cargo.toml

@@ -19,8 +19,13 @@ path = "lib.rs"
 
 [features]
 default = []
-experimental-module-builds = ["i-slint-compiler/experimental-library-module"]
+## Enable the [`CompilerConfiguration::with_sdf_fonts`] function that encodes the font's glyphs as scalable signed distance fields, to reduce the size.
 sdf-fonts = ["i-slint-compiler/sdf-fonts"]
+## Enable this feature when building `.slint` libraries.
+## This feature is experimental and may change or be removed in the future,
+## enabling it implies opting out of [semver](https://semver.org).
+## For details of this experiment, see: <https://github.com/slint-ui/slint/issues/7060>
+experimental-module-builds = ["i-slint-compiler/experimental-library-module"]
 
 [dependencies]
 i-slint-compiler = { workspace = true, features = ["default", "rust", "display-diagnostics", "software-renderer", "bundle-translations"] }
@@ -30,5 +35,5 @@ toml_edit = { workspace = true }
 derive_more = { workspace = true, features = ["std", "error"] }
 
 [package.metadata.docs.rs]
-all-features = true
+features = ["sdf-fonts"]
 rustdoc-args = ["--generate-link-to-definition"]

api/rs/build/lib.rs

@@ -209,6 +209,8 @@ impl CompilerConfiguration {
     ///
     /// Use this when the components and types of the Slint code need
     /// to be accessible from other modules.
+    ///
+    /// **Note**: This feature is experimental and may change or be removed in the future.
     #[cfg(feature = "experimental-module-builds")]
     #[must_use]
     pub fn as_library(self, library_name: &str) -> Self {
@@ -218,6 +220,8 @@ impl CompilerConfiguration {
     }
 
     /// Specify the Rust module to place the generated code in.
+    ///
+    /// **Note**: This feature is experimental and may change or be removed in the future.
     #[cfg(feature = "experimental-module-builds")]
     #[must_use]
     pub fn rust_module(self, rust_module: &str) -> Self {