diff --git a/substrate/client/network/src/config.rs b/substrate/client/network/src/config.rs
index 6ba31272da..8c100875be 100644
--- a/substrate/client/network/src/config.rs
+++ b/substrate/client/network/src/config.rs
@@ -402,8 +402,8 @@ pub struct NetworkConfiguration {
 	/// presence of potentially adversarial nodes.
 	pub kademlia_disjoint_query_paths: bool,
 
-	/// Size of Yamux window receive window of all substreams. `None` for the default (256kiB).
-	/// Any value inferior to 256kiB is invalid.
+	/// Size of Yamux receive window of all substreams. `None` for the default (256kiB).
+	/// Any value less than 256kiB is invalid.
 	///
 	/// # Context
 	///
diff --git a/substrate/client/network/src/transport.rs b/substrate/client/network/src/transport.rs
index 6896e59856..da0e5aa059 100644
--- a/substrate/client/network/src/transport.rs
+++ b/substrate/client/network/src/transport.rs
@@ -35,8 +35,8 @@ pub use self::bandwidth::BandwidthSinks;
 /// If `memory_only` is true, then only communication within the same process are allowed. Only
 /// addresses with the format `/memory/...` are allowed.
 ///
-/// `yamux_window_size` consists in the size of the Yamux windows. `None` to leave the default
-/// (256kiB).
+///`yamux_window_size` is the maximum size of the Yamux receive windows. `None` to leave the
+/// default (256kiB).
 ///
 /// Returns a `BandwidthSinks` object that allows querying the average bandwidth produced by all
 /// the connections spawned with this transport.