update attempt comment

Author: stephanos

openapi/openapiv2.json

@@ -15820,7 +15820,7 @@
         "attempt": {
           "type": "integer",
           "format": "int32",
-          "description": "The number of attempts made to start/deliver the operation request.\nThis number represents a minimum bound since the attempt is incremented after the request completes."
+          "description": "The number of attempts made to deliver the start operation request.\nThis number is approximate, it is incremented when a task is added to the history queue.\nIn practice, there could be more attempts if a task is executed but fails to commit, or less attempts if a task\nwas never executed."
         },
         "scheduleTime": {
           "type": "string",
@@ -16368,7 +16368,7 @@
         "attempt": {
           "type": "integer",
           "format": "int32",
-          "description": "The number of attempts made to deliver the start operation request.\nThis number represents a minimum bound since the attempt is incremented after the request completes."
+          "description": "The number of attempts made to deliver the start operation request.\nThis number is approximate, it is incremented when a task is added to the history queue.\nIn practice, there could be more attempts if a task is executed but fails to commit, or less attempts if a task\nwas never executed."
         },
         "lastAttemptCompleteTime": {
           "type": "string",

openapi/openapiv3.yaml

@@ -12408,8 +12408,10 @@ components:
         attempt:
           type: integer
           description: |-
-            The number of attempts made to start/deliver the operation request.
-             This number represents a minimum bound since the attempt is incremented after the request completes.
+            The number of attempts made to deliver the start operation request.
+             This number is approximate, it is incremented when a task is added to the history queue.
+             In practice, there could be more attempts if a task is executed but fails to commit, or less attempts if a task
+             was never executed.
           format: int32
         scheduleTime:
           type: string
@@ -13003,7 +13005,9 @@ components:
           type: integer
           description: |-
             The number of attempts made to deliver the start operation request.
-             This number represents a minimum bound since the attempt is incremented after the request completes.
+             This number is approximate, it is incremented when a task is added to the history queue.
+             In practice, there could be more attempts if a task is executed but fails to commit, or less attempts if a task
+             was never executed.
           format: int32
         lastAttemptCompleteTime:
           type: string

temporal/api/nexus/v1/message.proto

@@ -276,8 +276,10 @@ message NexusOperationExecutionInfo {
     //     aip.dev/not-precedent: "to" is used to indicate interval. --)
     google.protobuf.Duration start_to_close_timeout = 10;
 
-    // The number of attempts made to start/deliver the operation request.
-    // This number represents a minimum bound since the attempt is incremented after the request completes.
+    // The number of attempts made to deliver the start operation request.
+    // This number is approximate, it is incremented when a task is added to the history queue.
+    // In practice, there could be more attempts if a task is executed but fails to commit, or less attempts if a task
+    // was never executed.
     int32 attempt = 11;
 
     // Time the operation was originally scheduled via a StartNexusOperation request.

temporal/api/workflow/v1/message.proto

@@ -515,7 +515,9 @@ message PendingNexusOperationInfo {
     temporal.api.enums.v1.PendingNexusOperationState state = 7;
 
     // The number of attempts made to deliver the start operation request.
-    // This number represents a minimum bound since the attempt is incremented after the request completes.
+    // This number is approximate, it is incremented when a task is added to the history queue.
+    // In practice, there could be more attempts if a task is executed but fails to commit, or less attempts if a task
+    // was never executed.
     int32 attempt = 8;
 
     // The time when the last attempt completed.
@@ -753,4 +755,3 @@ message WorkflowExecutionPauseInfo {
     // The reason for pausing the workflow execution.
     string reason = 3;
 }
-