diff --git a/Documentation/developer-guide.md b/Documentation/developer-guide.md
index 5b64e5e..d36a24d 100644
--- a/Documentation/developer-guide.md
+++ b/Documentation/developer-guide.md
@@ -70,6 +70,16 @@
 http://localhost:8080/ to view your local copy of gitiles, which
 will serve any repositories under `/path/to/repositories`.
 
+Passing `--debug` option to `tools/run_dev.sh` will suspend the runtime until a
+remote debugger connects to port 5005. If you don't want to suspend the
+runtime, make sure to assign value `n` to environment variable
+`DEFAULT_JVM_DEBUG_SUSPEND`:
+
+```
+cd /path/to/repositories  # Don't run from the gitiles repo.
+export DEFAULT_JVM_DEBUG_SUSPEND=n; /path/to/gitiles/tools/run_dev.sh --debug
+```
+
 To run unit tests, refer to the aforementioned bazel test command.
 
 ## Pushing your changes