Document features for docs.rs (#2367)

Resolves #2223

Author: heaths

Cargo.toml

@@ -134,3 +134,6 @@ zip = { version = "2.2.3", default-features = false, features = ["deflate"] }
 
 [workspace.lints.clippy]
 large_futures = "deny"
+
+[workspace.lints.rust]
+unexpected_cfgs = { level = "warn", check-cfg = ['cfg(docsrs)'] }

sdk/core/azure_core/Cargo.toml

@@ -60,6 +60,9 @@ tokio_process = ["dep:tokio", "tokio/process"]
 tokio_sleep = ["typespec_client_core/tokio_sleep"]
 xml = ["typespec_client_core/xml"]
 
+[lints]
+workspace = true
+
 [package.metadata.docs.rs]
 features = [
   "hmac_openssl",

sdk/core/azure_core/src/lib.rs

@@ -3,8 +3,8 @@
 
 #![forbid(unsafe_code)]
 #![deny(missing_debug_implementations, nonstandard_style)]
-// #![warn(missing_docs, future_incompatible, unreachable_pub)]
 #![doc = include_str!("../README.md")]
+#![cfg_attr(docsrs, feature(doc_auto_cfg))]
 
 #[macro_use]
 mod macros;

sdk/core/azure_core_amqp/Cargo.toml

@@ -47,5 +47,8 @@ fe2o3_amqp = [
   "serde_bytes",
 ]
 
+[lints]
+workspace = true
+
 [package.metadata.docs.rs]
 features = ["fe2o3_amqp"]

sdk/core/azure_core_amqp/src/lib.rs

@@ -2,6 +2,7 @@
 // Licensed under the MIT License.
 
 #![doc = include_str!("../README.md")]
+#![cfg_attr(docsrs, feature(doc_auto_cfg))]
 
 #[cfg(all(feature = "fe2o3_amqp", not(target_arch = "wasm32")))]
 mod fe2o3;

sdk/eventhubs/azure_messaging_eventhubs/Cargo.toml

@@ -34,3 +34,6 @@ azure_core_test.workspace = true
 azure_identity.workspace = true
 tokio = { workspace = true, features = ["rt-multi-thread", "macros", "time"] }
 tracing-subscriber = { workspace = true, features = ["env-filter", "fmt"] }
+
+[lints]
+workspace = true

sdk/eventhubs/azure_messaging_eventhubs/src/lib.rs

@@ -4,6 +4,7 @@
 #![recursion_limit = "128"]
 #![warn(missing_docs)]
 #![doc = include_str!("../README.md")]
+#![cfg_attr(docsrs, feature(doc_auto_cfg))]
 
 pub(crate) mod common;
 

sdk/identity/azure_identity/Cargo.toml

@@ -53,6 +53,9 @@ client_certificate = ["openssl"]
 # https://github.com/Azure/azure-cli/issues/19700
 old_azure_cli = ["time/local-offset", "tz-rs"]
 
+[lints]
+workspace = true
+
 [package.metadata.docs.rs]
 features = [
   "client_certificate",

sdk/identity/azure_identity/src/lib.rs

@@ -2,6 +2,7 @@
 // Licensed under the MIT License.
 
 #![doc = include_str!("../README.md")]
+#![cfg_attr(docsrs, feature(doc_auto_cfg))]
 
 mod authorization_code_flow;
 mod azure_pipelines_credential;

sdk/typespec/Cargo.toml

@@ -25,3 +25,6 @@ default = ["http", "json"]
 http = []
 json = ["dep:serde", "dep:serde_json"]
 amqp = []
+
+[lints]
+workspace = true

sdk/typespec/src/lib.rs

@@ -2,6 +2,7 @@
 // Licensed under the MIT License.
 
 #![doc = include_str!("../README.md")]
+#![cfg_attr(docsrs, feature(doc_auto_cfg))]
 
 pub mod error;
 #[cfg(feature = "http")]

sdk/typespec/typespec_client_core/Cargo.toml

@@ -79,3 +79,6 @@ features = [
   "tokio_sleep",
   "xml",
 ]
+
+[lints]
+workspace = true

sdk/typespec/typespec_client_core/src/lib.rs

@@ -2,6 +2,7 @@
 // Licensed under the MIT License.
 
 #![doc = include_str!("../README.md")]
+#![cfg_attr(docsrs, feature(doc_auto_cfg))]
 
 #[macro_use]
 mod macros;