edit

Author: dandavison

temporal-sdk/src/main/java/io/temporal/internal/statemachines/WorkflowStateMachines.java

@@ -484,14 +484,14 @@ private void handleSingleEvent(HistoryEvent event, boolean lastTask, boolean has
   }
 
   /**
-   * Handles command event. Command event is an event which is generated from a command emitted by a
-   * past decision. Each command has a correspondent event. For example ScheduleActivityTaskCommand
-   * is recorded to the history as ActivityTaskScheduledEvent.
+   * Handle a command event. A command event is an event which was generated by a command emitted by
+   * a past event. Each command has precisely one corresponding event. For example a
+   * ScheduleActivityTask command gives rise to an ActivityTaskScheduled history event.
    *
-   * <p>Command events always follow WorkflowTaskCompletedEvent.
+   * <p>Command events always follow a WorkflowTaskCompleted event.
    *
-   * <p>The handling consists from verifying that the next command in the commands queue matches the
-   * event, command state machine is notified about the event and the command is removed from the
+   * <p>The handling consists of verifying that the next command in the commands queue matches the
+   * event, the command state machine is notified about the event and the command is removed from the
    * commands queue.
    */
   private void handleCommandEvent(HistoryEvent event) {