Miscellaneous docstring and comment edits (#2154)

Author: dandavison

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

@@ -3,7 +3,7 @@
 import io.temporal.common.converter.EncodedValues;
 
 /**
- * Use DynamicQueryHandler to process any query dynamically. This is useful for a library level code
+ * Use DynamicQueryHandler to process any query dynamically. This is useful for library-level code
  * and implementation of DSLs.
  *
  * <p>Use {@link Workflow#registerListener(Object)} to register an implementation of the

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

@@ -3,8 +3,8 @@
 import io.temporal.common.converter.EncodedValues;
 
 /**
- * Use DynamicSignalHandler to process any signal dynamically. This is useful for a library level
- * code and implementation of DSLs.
+ * Use DynamicSignalHandler to process any signal dynamically. This is useful for library-level code
+ * and implementation of DSLs.
  *
  * <p>Use {@link Workflow#registerListener(Object)} to register an implementation of the
  * DynamicSignalListener. Only one such listener can be registered per workflow execution.

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

@@ -3,13 +3,13 @@
 import io.temporal.common.converter.EncodedValues;
 
 /**
- * Use DynamicUpdateHandler to process any update dynamically. This is useful for a library level
- * code and implementation of DSLs.
+ * Use DynamicUpdateHandler to process any update dynamically. This is useful for library-level code
+ * and implementation of DSLs.
  *
  * <p>Use {@link Workflow#registerListener(Object)} to register an implementation of the
  * DynamicUpdateListener. Only one such listener can be registered per workflow execution.
  *
- * <p>When registered any signals which don't have a specific handler will be delivered to it.
+ * <p>When registered any updates which don't have a specific handler will be delivered to it.
  *
  * @see DynamicQueryHandler
  * @see DynamicSignalHandler

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

@@ -11,7 +11,7 @@
  * one type that implements DynamicWorkflow per worker is allowed.
  *
  * <p>The main use case for DynamicWorkflow is an implementation of custom Domain Specific Languages
- * (DSLs). A single implementation can implement a workflow type which definition is dynamically
+ * (DSLs). A single implementation can implement a workflow type whose definition is dynamically
  * loaded from some external source.
  *
  * <p>Use {@link Workflow#getInfo()} to query information about the workflow type that should be

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

@@ -5,9 +5,9 @@
 import javax.annotation.Nullable;
 
 /**
- * Supports signalling and cancelling any workflows by the workflow type and their id. This is
- * useful when an external workflow type is not known at the compile time and to call workflows in
- * other languages.
+ * Supports signalling and cancelling any workflow by the workflow type and their id. This is useful
+ * when an external workflow type is not known at compile time and to call workflows in other
+ * languages.
  *
  * @see Workflow#newUntypedExternalWorkflowStub(String)
  */
@@ -28,7 +28,7 @@ static <T> ExternalWorkflowStub fromTyped(T typed) {
     }
     if (typed instanceof ChildWorkflowStub) {
       throw new IllegalArgumentException(
-          "Use ChildWorkflowStub.fromTyped to extract sbub created through Workflow#newChildWorkflowStub");
+          "Use ChildWorkflowStub.fromTyped to extract stub created through Workflow#newChildWorkflowStub");
     }
     @SuppressWarnings("unchecked")
     StubMarker supplier = (StubMarker) typed;

temporal-sdk/src/main/java/io/temporal/workflow/package-info.java

@@ -1,6 +1,6 @@
 /**
  * Workflow encapsulates the orchestration of activities and child workflows. It can also answer to
- * synchronous queries and receive external events (also known as signals).
+ * synchronous queries and receive other external requests (signals and updates).
  *
  * <h2>Workflow Interface</h2>
  *
@@ -45,15 +45,15 @@
  * started, a new instance of the workflow implementation object is created. Then, one of the
  * methods (depending on which workflow type has been started) annotated with {@literal @}{@link
  * io.temporal.workflow.WorkflowMethod} is invoked. As soon as this method returns the workflow,
- * execution is closed. While workflow execution is open, it can receive calls to signal and query
- * methods. No additional calls to workflow methods are allowed. The workflow object is stateful, so
- * query and signal methods can communicate with the other parts of the workflow through workflow
- * object fields.
+ * execution is closed. While the workflow execution is open, it can receive calls to signal,
+ * update, and query methods. No additional calls to workflow methods are allowed. The workflow
+ * object is stateful, so query, signal, and update methods can communicate with the other parts of
+ * the workflow through workflow object fields.
  *
  * <h3>Calling Activities</h3>
  *
  * {@link io.temporal.workflow.Workflow#newActivityStub(Class)} returns a client-side stub that
- * implements an activity interface. It takes activity type and activity options as arguments.
+ * implements an activity interface. It takes an activity type and activity options as arguments.
  * Activity options are needed only if some of the required timeouts are not specified through the
  * {@literal @}{@link io.temporal.activity.ActivityMethod} annotation.
  *