diff --git a/substrate/client/network/src/config.rs b/substrate/client/network/src/config.rs
index 6ba31272da56bd1734006812f919ca73aae88233..8c100875bef7ce55673a36b14131fb3a3b0b8848 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 6896e598563785a1d67c215db7724abf58b01004..da0e5aa059b6db5ea6e218fa4edb067ee670574e 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.