edits

Author: dandavison

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

@@ -23,14 +23,14 @@
 import java.lang.reflect.Type;
 
 /**
- * ActivityStub is used to call an activity without referencing an interface it implements. This is
- * useful to call activities when their type is not known at compile time or to execute activities
+ * ActivityStub is used to call an activity without referencing the interface that it implements. This is
+ * useful for calling activities when their type is not known at compile time, or for executing activities
  * implemented in other languages. Created through {@link Workflow#newActivityStub(Class)}.
  */
 public interface ActivityStub {
 
   /**
-   * Executes an activity by its type name and arguments. Blocks until the activity completion.
+   * Executes an activity by its type name and arguments. Blocks until activity completion.
    *
    * @param activityName name of an activity type to execute.
    * @param resultClass the expected return type of the activity. Use Void.class for activities that
@@ -42,7 +42,7 @@ public interface ActivityStub {
   <R> R execute(String activityName, Class<R> resultClass, Object... args);
 
   /**
-   * Executes an activity by its type name and arguments. Blocks until the activity completion.
+   * Executes an activity by its type name and arguments. Blocks until activity completion.
    *
    * @param activityName name of an activity type to execute.
    * @param resultClass the expected return class of the activity. Use Void.class for activities

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

@@ -29,7 +29,7 @@
 public final class Async {
 
   /**
-   * Invokes zero argument function asynchronously.
+   * Invokes a zero-argument function asynchronously.
    *
    * @param function Function to execute asynchronously
    * @return promise that contains function result or failure
@@ -39,7 +39,7 @@ public static <R> Promise<R> function(Functions.Func<R> function) {
   }
 
   /**
-   * Invokes one argument function asynchronously.
+   * Invokes a one-argument function asynchronously.
    *
    * @param function Function to execute asynchronously
    * @param arg1 first function argument