diff --git a/substrate/client/cli/src/params/shared_params.rs b/substrate/client/cli/src/params/shared_params.rs
index 8f22070800..58aabb3148 100644
--- a/substrate/client/cli/src/params/shared_params.rs
+++ b/substrate/client/cli/src/params/shared_params.rs
@@ -32,6 +32,9 @@ pub struct SharedParams {
 	pub chain: Option<String>,
 
 	/// Specify the development chain.
+	///
+	/// This flag sets `--chain=dev`, `--force-authoring`, `--rpc-cors=all`,
+	/// `--alice`, and `--tmp` flags, unless explicitly overridden.
 	#[structopt(long, conflicts_with_all = &["chain"])]
 	pub dev: bool,