Add a comment
diff --git a/lang/java/reef-wake/wake/src/main/java/org/apache/reef/wake/remote/RemoteConfiguration.java b/lang/java/reef-wake/wake/src/main/java/org/apache/reef/wake/remote/RemoteConfiguration.java
index a3efe69..4e3dfa2 100644
--- a/lang/java/reef-wake/wake/src/main/java/org/apache/reef/wake/remote/RemoteConfiguration.java
+++ b/lang/java/reef-wake/wake/src/main/java/org/apache/reef/wake/remote/RemoteConfiguration.java
@@ -39,6 +39,10 @@
/**
* The timeout of connection retrying.
+ * To prevent retrying connections from being rejected by the remote stages,
+ * the retrying_timeout * number_of_retries should be less than the remote_executor_shutdown_timeout.
+ * If not, the remote stage can shutdown the connection retries before it is established,
+ * and can drop a message that should be sent to the remote.
*/
public static final long REMOTE_CONNECTION_RETRY_TIMEOUT =
WakeParameters.REMOTE_EXECUTOR_SHUTDOWN_TIMEOUT / (REMOTE_CONNECTION_NUMBER_OF_RETRIES + 1);
