doc strings

Author: spkane31

openapi/openapiv2.json

@@ -15262,14 +15262,16 @@
           "title": "Reason indicates the reason to stop a operation"
         },
         "query": {
-          "type": "string"
+          "type": "string",
+          "title": "Query is the visibility query that defines the group of workflow to apply the batch operation"
         },
         "executions": {
           "type": "array",
           "items": {
             "type": "object",
             "$ref": "#/definitions/v1Execution"
-          }
+          },
+          "title": "Executions is the list of workflow executions to apply the batch operation"
         }
       }
     },

openapi/openapiv3.yaml

@@ -11721,10 +11721,12 @@ components:
           description: Reason indicates the reason to stop a operation
         query:
           type: string
+          description: Query is the visibility query that defines the group of workflow to apply the batch operation
         executions:
           type: array
           items:
             $ref: '#/components/schemas/Execution'
+          description: Executions is the list of workflow executions to apply the batch operation
     DescribeDeploymentResponse:
       type: object
       properties:

temporal/api/workflowservice/v1/request_response.proto

@@ -1911,7 +1911,9 @@ message DescribeBatchOperationResponse {
     string identity = 9;
     // Reason indicates the reason to stop a operation
     string reason = 10;
+    // Query is the visibility query that defines the group of workflow to apply the batch operation
     string query = 11;
+    // Executions is the list of workflow executions to apply the batch operation
     repeated temporal.api.common.v1.Execution executions = 12;
 }