diff --git a/docs/sdk/src/reference_docs/development_environment_advice.rs b/docs/sdk/src/reference_docs/development_environment_advice.rs
index a5f38bb280deff9cc3b1ffb0d2a5d08dced39d55..104782933da744f619e6205cdc741dc0f103b013 100644
--- a/docs/sdk/src/reference_docs/development_environment_advice.rs
+++ b/docs/sdk/src/reference_docs/development_environment_advice.rs
@@ -109,6 +109,10 @@
 //!
 //! ### Cargo Remote
 //!
+//! Warning: cargo remote by default doesn't transfer hidden files to the remote machine. But hidden
+//! files can be useful, e.g. for sqlx usage. On the other hand using `--transfer-hidden` flag will
+//! transfer `.git` which is big.
+//!
 //! If you have a powerful remote server available, you may consider using
 //! [cargo-remote](https://github.com/sgeisler/cargo-remote) to execute cargo commands on it,
 //! freeing up local resources for other tasks like `rust-analyzer`.