move comment to where it matters

Author: stephanos

temporal/api/enums/v1/nexus.proto

@@ -21,8 +21,6 @@ enum NexusHandlerErrorRetryBehavior {
 }
 
 // Status of a standalone Nexus operation.
-// The status is updated once, when the operation is originally scheduled, and again when the operation reaches a
-// terminal status.
 // (-- api-linter: core::0216::synonyms=disabled
 //     aip.dev/not-precedent: Named consistently with WorkflowExecutionStatus. --)
 enum NexusOperationStatus {

temporal/api/nexus/v1/message.proto

@@ -242,7 +242,7 @@ message NexusOperationCancellationInfo {
     string reason = 8;
 }
 
-// Information about a standalone Nexus operation.
+// Full current state of a standalone Nexus operation, as of the time of the request.
 message NexusOperationInfo {
     // Unique identifier of this Nexus operation within its namespace along with run ID (below).
     string operation_id = 1;
@@ -334,8 +334,8 @@ message NexusOperationListInfo {
     google.protobuf.Timestamp schedule_time = 6;
     // If the operation is in a terminal status, this field represents the time the operation transitioned to that status.
     google.protobuf.Timestamp close_time = 7;
-    // Only scheduled and terminal statuses appear here. More detailed information in PendingNexusOperationInfo but not
-    // available in the list response.
+    // Set once when the operation is scheduled and updated once when it reaches a terminal status.
+    // Use DescribeNexusOperation for full current state.
     temporal.api.enums.v1.NexusOperationStatus status = 8;
 
     // Search attributes from the start request.