Merge branch 'master' into feature/improve-wf-update-comments

openapi/openapiv2.json

@@ -1173,7 +1173,7 @@
           },
           {
             "name": "versions.allActive",
-            "description": "Include all active versions. A version is considered active if it has had new\ntasks or polls recently.",
+            "description": "Include all active versions. A version is considered active if, in the last few minutes,\nit has had new tasks or polls, or it has been the subject of certain task queue API calls.",
             "in": "query",
             "required": false,
             "type": "boolean"
@@ -3710,7 +3710,7 @@
           },
           {
             "name": "versions.allActive",
-            "description": "Include all active versions. A version is considered active if it has had new\ntasks or polls recently.",
+            "description": "Include all active versions. A version is considered active if, in the last few minutes,\nit has had new tasks or polls, or it has been the subject of certain task queue API calls.",
             "in": "query",
             "required": false,
             "type": "boolean"
@@ -10883,7 +10883,7 @@
         },
         "allActive": {
           "type": "boolean",
-          "description": "Include all active versions. A version is considered active if it has had new\ntasks or polls recently."
+          "description": "Include all active versions. A version is considered active if, in the last few minutes,\nit has had new tasks or polls, or it has been the subject of certain task queue API calls."
         }
       },
       "description": "Used for specifying versions the caller is interested in."

openapi/openapiv3.yaml

@@ -1049,8 +1049,8 @@ paths:
         - name: versions.allActive
           in: query
           description: |-
-            Include all active versions. A version is considered active if it has had new
-             tasks or polls recently.
+            Include all active versions. A version is considered active if, in the last few minutes,
+             it has had new tasks or polls, or it has been the subject of certain task queue API calls.
           schema:
             type: boolean
         - name: taskQueueTypes
@@ -3251,8 +3251,8 @@ paths:
         - name: versions.allActive
           in: query
           description: |-
-            Include all active versions. A version is considered active if it has had new
-             tasks or polls recently.
+            Include all active versions. A version is considered active if, in the last few minutes,
+             it has had new tasks or polls, or it has been the subject of certain task queue API calls.
           schema:
             type: boolean
         - name: taskQueueTypes

temporal/api/sdk/v1/workflow_metadata.proto

@@ -45,8 +45,14 @@ message WorkflowDefinition {
   // A name scoped by the task queue that maps to this workflow definition.
   // If missing, this workflow is a dynamic workflow.
   string type = 1;
+
+  // Query definitions, sorted by name.
   repeated WorkflowInteractionDefinition query_definitions = 2;
+
+  // Signal definitions, sorted by name.
   repeated WorkflowInteractionDefinition signal_definitions = 3;
+
+  // Update definitions, sorted by name.
   repeated WorkflowInteractionDefinition update_definitions = 4;
 }
 

temporal/api/taskqueue/v1/message.proto

@@ -60,8 +60,8 @@ message TaskQueueVersionSelection {
     repeated string build_ids = 1;
     // Include the unversioned queue.
     bool unversioned = 2;
-    // Include all active versions. A version is considered active if it has had new
-    // tasks or polls recently.
+    // Include all active versions. A version is considered active if, in the last few minutes,
+    // it has had new tasks or polls, or it has been the subject of certain task queue API calls.
     bool all_active = 3;
 }