Mark pause activity by type API as experimental (#642)

<!-- Describe what has changed in this PR -->
What: Annotating the pause activity by type parameter as experimental.


<!-- Tell your future self why have you made these changes -->
Why: We might revisit this API and change its behavior. So marking it as
experimental.

Author: gow

openapi/openapiv2.json

@@ -2906,7 +2906,7 @@
     },
     "/api/v1/namespaces/{namespace}/workflows/{execution.workflowId}/history-reverse": {
       "get": {
-        "summary": "GetWorkflowExecutionHistoryReverse returns the history of specified workflow execution in reverse \norder (starting from last event). Fails with`NotFound` if the specified workflow execution is \nunknown to the service.",
+        "summary": "GetWorkflowExecutionHistoryReverse returns the history of specified workflow execution in reverse\norder (starting from last event). Fails with`NotFound` if the specified workflow execution is\nunknown to the service.",
         "operationId": "GetWorkflowExecutionHistoryReverse2",
         "responses": {
           "200": {
@@ -6731,7 +6731,7 @@
     },
     "/namespaces/{namespace}/workflows/{execution.workflowId}/history-reverse": {
       "get": {
-        "summary": "GetWorkflowExecutionHistoryReverse returns the history of specified workflow execution in reverse \norder (starting from last event). Fails with`NotFound` if the specified workflow execution is \nunknown to the service.",
+        "summary": "GetWorkflowExecutionHistoryReverse returns the history of specified workflow execution in reverse\norder (starting from last event). Fails with`NotFound` if the specified workflow execution is\nunknown to the service.",
         "operationId": "GetWorkflowExecutionHistoryReverse",
         "responses": {
           "200": {
@@ -8029,7 +8029,7 @@
         },
         "type": {
           "type": "string",
-          "description": "Pause all running activities of this type."
+          "description": "Pause all running activities of this type.\nNote: Experimental - the behavior of pause by activity type might change in a future release."
         },
         "reason": {
           "type": "string",

openapi/openapiv3.yaml

@@ -2610,7 +2610,10 @@ paths:
     get:
       tags:
         - WorkflowService
-      description: "GetWorkflowExecutionHistoryReverse returns the history of specified workflow execution in reverse \n order (starting from last event). Fails with`NotFound` if the specified workflow execution is \n unknown to the service."
+      description: |-
+        GetWorkflowExecutionHistoryReverse returns the history of specified workflow execution in reverse
+         order (starting from last event). Fails with`NotFound` if the specified workflow execution is
+         unknown to the service.
       operationId: GetWorkflowExecutionHistoryReverse
       parameters:
         - name: namespace
@@ -6031,7 +6034,10 @@ paths:
     get:
       tags:
         - WorkflowService
-      description: "GetWorkflowExecutionHistoryReverse returns the history of specified workflow execution in reverse \n order (starting from last event). Fails with`NotFound` if the specified workflow execution is \n unknown to the service."
+      description: |-
+        GetWorkflowExecutionHistoryReverse returns the history of specified workflow execution in reverse
+         order (starting from last event). Fails with`NotFound` if the specified workflow execution is
+         unknown to the service.
       operationId: GetWorkflowExecutionHistoryReverse
       parameters:
         - name: namespace
@@ -9613,7 +9619,9 @@ components:
           description: Only the activity with this ID will be paused.
         type:
           type: string
-          description: Pause all running activities of this type.
+          description: |-
+            Pause all running activities of this type.
+             Note: Experimental - the behavior of pause by activity type might change in a future release.
         reason:
           type: string
           description: Reason to pause the activity.

temporal/api/workflowservice/v1/request_response.proto

@@ -1940,6 +1940,7 @@ message PauseActivityRequest {
         // Only the activity with this ID will be paused.
         string id = 4;
         // Pause all running activities of this type.
+        // Note: Experimental - the behavior of pause by activity type might change in a future release.
         string type = 5;
     }
 
@@ -2258,8 +2259,8 @@ message ListWorkerDeploymentsResponse {
         google.protobuf.Timestamp create_time = 2;
         temporal.api.deployment.v1.RoutingConfig routing_config = 3;
         // Summary of the version that was added most recently in the Worker Deployment.
-        temporal.api.deployment.v1.WorkerDeploymentInfo.WorkerDeploymentVersionSummary latest_version_summary = 4; 
-        // Summary of the current version of the Worker Deployment. 
+        temporal.api.deployment.v1.WorkerDeploymentInfo.WorkerDeploymentVersionSummary latest_version_summary = 4;
+        // Summary of the current version of the Worker Deployment.
         temporal.api.deployment.v1.WorkerDeploymentInfo.WorkerDeploymentVersionSummary current_version_summary = 5;
         // Summary of the ramping version of the Worker Deployment.
         temporal.api.deployment.v1.WorkerDeploymentInfo.WorkerDeploymentVersionSummary ramping_version_summary = 6;
@@ -2591,4 +2592,4 @@ message DescribeWorkerRequest {
 
 message DescribeWorkerResponse {
     temporal.api.worker.v1.WorkerInfo worker_info = 1;
-}
+}

temporal/api/workflowservice/v1/service.proto

@@ -133,9 +133,9 @@ service WorkflowService {
             }
         };
     }
-    
-    // GetWorkflowExecutionHistoryReverse returns the history of specified workflow execution in reverse 
-    // order (starting from last event). Fails with`NotFound` if the specified workflow execution is 
+
+    // GetWorkflowExecutionHistoryReverse returns the history of specified workflow execution in reverse
+    // order (starting from last event). Fails with`NotFound` if the specified workflow execution is
     // unknown to the service.
     rpc GetWorkflowExecutionHistoryReverse (GetWorkflowExecutionHistoryReverseRequest) returns (GetWorkflowExecutionHistoryReverseResponse) {
         option (google.api.http) = {
@@ -670,8 +670,8 @@ service WorkflowService {
     // members are compatible with one another.
     //
     // A single build id may be mapped to multiple task queues using this API for cases where a single process hosts
-    // multiple workers. 
-    // 
+    // multiple workers.
+    //
     // To query which workers can be retired, use the `GetWorkerTaskReachability` API.
     //
     // NOTE: The number of task queues mapped to a single build id is limited by the `limit.taskQueuesPerBuildId`