Update some docs

Author: Quinn-With-Two-Ns

temporal-sdk/src/main/java/io/temporal/nexus/TemporalNexusClient.java

@@ -15,9 +15,7 @@
  * Nexus-aware client wrapping {@link WorkflowClient}. Provides methods for interacting with
  * Temporal workflows from within a Nexus operation handler.
  *
- * <p>Obtained via the {@link TemporalOperationHandler.StartFunction} parameter. The client creates
- * workflow stubs internally — users pass the workflow class, a lambda that calls the workflow
- * method, and workflow options.
+ * <p>Obtained via the {@link TemporalOperationHandler.StartFunction} parameter.
  *
  * <p>Usage example:
  *
@@ -29,7 +27,7 @@
  *         OrderWorkflow.class,
  *         wf -> wf.processOrder(input),
  *         WorkflowOptions.newBuilder()
- *             .setWorkflowId("order-" + context.getRequestId())
+ *             .setWorkflowId("order-" + input.getOrderId())
  *             .build());
  *   });
  * }

temporal-sdk/src/main/java/io/temporal/nexus/TemporalOperationCancelContext.java

@@ -6,9 +6,8 @@
 import java.util.Objects;
 
 /**
- * Context for a Nexus cancel operation. Combines the {@link OperationContext} and {@link
- * OperationCancelDetails} into a single object passed to cancel methods on {@link
- * TemporalOperationHandler}.
+ * Context for a Nexus cancel operation request, passed to {@link
+ * TemporalOperationHandler#cancelWorkflowRun}.
  */
 @Experimental
 public final class TemporalOperationCancelContext {

temporal-sdk/src/main/java/io/temporal/nexus/TemporalOperationHandler.java

@@ -24,7 +24,7 @@
  *         OrderWorkflow.class,
  *         wf -> wf.processOrder(input),
  *         WorkflowOptions.newBuilder()
- *             .setWorkflowId("order-" + context.getRequestId())
+ *             .setWorkflowId("order-" + input.getOrderId())
  *             .build());
  *   });
  * }

temporal-sdk/src/main/java/io/temporal/nexus/TemporalOperationStartContext.java

@@ -6,9 +6,8 @@
 import java.util.Objects;
 
 /**
- * Context for a Nexus start operation. Combines the {@link OperationContext} and {@link
- * OperationStartDetails} into a single object passed to {@link
- * TemporalOperationHandler.StartFunction}.
+ * Context for a Nexus start operation request, passed to {@link
+ * TemporalOperationHandler.StartFunction} alongside the {@link TemporalNexusClient} and input.
  */
 @Experimental
 public final class TemporalOperationStartContext {
@@ -32,7 +31,7 @@ public String getOperation() {
     return operationContext.getOperation();
   }
 
-  /** Returns the request ID, commonly used as a workflow ID for idempotency. */
+  /** Returns the request ID for this operation. */
   public String getRequestId() {
     return operationStartDetails.getRequestId();
   }