Update docs for deadlock detection timeout

Author: dplyukhin

temporal-sdk/src/main/java/io/temporal/internal/sync/DeterministicRunner.java

@@ -52,8 +52,8 @@ static DeterministicRunner newRunner(
    * completed or blocked.
    *
    * @throws Throwable if one of the threads didn't handle an exception.
-   * @param deadlockDetectionTimeout the maximum time in milliseconds a thread can run without
-   *     calling yield.
+   * @param deadlockDetectionTimeout the maximum time in milliseconds after a thread is
+   *     scheduled until it yields or completes.
    */
   void runUntilAllBlocked(long deadlockDetectionTimeout);
 

temporal-sdk/src/main/java/io/temporal/internal/sync/WorkflowThread.java

@@ -65,8 +65,8 @@ static WorkflowThread newThread(Runnable runnable, boolean detached, String name
   SyncWorkflowContext getWorkflowContext();
 
   /**
-   * @param deadlockDetectionTimeoutMs maximum time in milliseconds the thread can run before
-   *     calling yield.
+   * @param deadlockDetectionTimeoutMs the maximum time in milliseconds after a thread is
+   *     scheduled until it yields or completes.
    * @return true if coroutine made some progress.
    */
   boolean runUntilBlocked(long deadlockDetectionTimeoutMs);

temporal-sdk/src/main/java/io/temporal/internal/sync/WorkflowThreadContext.java

@@ -210,8 +210,8 @@ public String getYieldReason() {
   }
 
   /**
-   * @param deadlockDetectionTimeoutMs maximum time in milliseconds the thread can run before
-   *     calling yield. Discarded if {@code TEMPORAL_DEBUG} env variable is set.
+   * @param deadlockDetectionTimeoutMs the maximum time in milliseconds after a thread is scheduled
+   *     until it yields or completes. Discarded if {@code TEMPORAL_DEBUG} env variable is set.
    * @return true if thread made some progress. Which is await was unblocked and some code after it
    *     * was executed.
    */

temporal-sdk/src/main/java/io/temporal/worker/WorkerOptions.java

@@ -302,9 +302,9 @@ public Builder setLocalActivityWorkerOnly(boolean localActivityWorkerOnly) {
     /**
      * @param defaultDeadlockDetectionTimeoutMs time period in ms that will be used to detect
      *     workflows deadlock. Default is 1000ms, which is chosen if set to zero.
-     *     <p>Specifies an amount of time in milliseconds that workflow tasks are allowed to execute
-     *     without interruption. If workflow task runs longer than specified interval without
-     *     yielding (like calling an Activity), it will fail automatically.
+     *     <p>Specifies a time interval in milliseconds within which a workflow task must
+     *     yield (like calling an Activity) or complete. If a workflow task runs longer than
+     *     the specified interval or takes too long to begin running, it will fail automatically.
      * @return {@code this}
      * @see io.temporal.internal.sync.PotentialDeadlockException
      */