Add cross-reference @see tags between related wait/sleep methods

Link Workflow.sleep, Workflow.newTimer, Workflow.await, and Async.await
in Javadoc to help developers discover blocking vs non-blocking alternatives.

Author: mfateev

temporal-sdk/src/main/java/io/temporal/workflow/Async.java

@@ -240,6 +240,7 @@ public static <R> Promise<R> retry(
    *     contain code that mutates workflow state.
    * @return Promise that completes when the condition becomes true, or completes exceptionally with
    *     CanceledFailure if the enclosing CancellationScope is canceled.
+   * @see Workflow#await(java.util.function.Supplier) for a blocking version
    */
   public static Promise<Void> await(java.util.function.Supplier<Boolean> unblockCondition) {
     return WorkflowInternal.awaitAsync(unblockCondition);
@@ -258,6 +259,8 @@ public static Promise<Void> await(java.util.function.Supplier<Boolean> unblockCo
    *       <li>false if the timeout expired before the condition was satisfied
    *       <li>exceptionally with CanceledFailure if the enclosing CancellationScope is canceled
    *     </ul>
+   *
+   * @see Workflow#await(Duration, java.util.function.Supplier) for a blocking version
    */
   public static Promise<Boolean> await(
       Duration timeout, java.util.function.Supplier<Boolean> unblockCondition) {

temporal-sdk/src/main/java/io/temporal/workflow/Workflow.java

@@ -474,6 +474,7 @@ public static CancellationScope newDetachedCancellationScope(Runnable runnable)
    *
    * @return feature that becomes ready when at least specified number of seconds passes. promise is
    *     failed with {@link CanceledFailure} if enclosing scope is canceled.
+   * @see #sleep(Duration) for a blocking version
    */
   public static Promise<Void> newTimer(Duration delay) {
     return WorkflowInternal.newTimer(delay);
@@ -485,6 +486,7 @@ public static Promise<Void> newTimer(Duration delay) {
    *
    * @return feature that becomes ready when at least specified number of seconds passes. promise is
    *     failed with {@link CanceledFailure} if enclosing scope is canceled.
+   * @see #sleep(Duration) for a blocking version
    */
   public static Promise<Void> newTimer(Duration delay, TimerOptions options) {
     return WorkflowInternal.newTimer(delay, options);
@@ -566,12 +568,20 @@ public static long currentTimeMillis() {
     return WorkflowInternal.currentTimeMillis();
   }
 
-  /** Must be called instead of {@link Thread#sleep(long)} to guarantee determinism. */
+  /**
+   * Must be called instead of {@link Thread#sleep(long)} to guarantee determinism.
+   *
+   * @see #newTimer(Duration) for a non-blocking version that returns a Promise
+   */
   public static void sleep(Duration duration) {
     WorkflowInternal.sleep(duration);
   }
 
-  /** Must be called instead of {@link Thread#sleep(long)} to guarantee determinism. */
+  /**
+   * Must be called instead of {@link Thread#sleep(long)} to guarantee determinism.
+   *
+   * @see #newTimer(Duration) for a non-blocking version that returns a Promise
+   */
   public static void sleep(long millis) {
     WorkflowInternal.sleep(Duration.ofMillis(millis));
   }
@@ -585,6 +595,7 @@ public static void sleep(long millis) {
    *     contain any time based conditions. Use {@link #await(Duration, Supplier)} for those
    *     instead.
    * @throws CanceledFailure if thread (or current {@link CancellationScope} was canceled).
+   * @see Async#await(java.util.function.Supplier) for a non-blocking version that returns a Promise
    */
   public static void await(Supplier<Boolean> unblockCondition) {
     WorkflowInternal.await(
@@ -606,6 +617,8 @@ public static void await(Supplier<Boolean> unblockCondition) {
    *     Use timeout parameter for those.
    * @return false if timed out.
    * @throws CanceledFailure if thread (or current {@link CancellationScope} was canceled).
+   * @see Async#await(Duration, java.util.function.Supplier) for a non-blocking version that returns
+   *     a Promise
    */
   public static boolean await(Duration timeout, Supplier<Boolean> unblockCondition) {
     return WorkflowInternal.await(