diff --git a/openapi/openapiv2.json b/openapi/openapiv2.json
index 6c51e567..d6a657ee 100644
--- a/openapi/openapiv2.json
+++ b/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."
diff --git a/openapi/openapiv3.yaml b/openapi/openapiv3.yaml
index 81c689e9..ad4b2a09 100644
--- a/openapi/openapiv3.yaml
+++ b/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
diff --git a/temporal/api/sdk/v1/workflow_metadata.proto b/temporal/api/sdk/v1/workflow_metadata.proto
index e042b8b4..b982f5b2 100644
--- a/temporal/api/sdk/v1/workflow_metadata.proto
+++ b/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;
 }
 
diff --git a/temporal/api/taskqueue/v1/message.proto b/temporal/api/taskqueue/v1/message.proto
index 9b19271d..866829c4 100644
--- a/temporal/api/taskqueue/v1/message.proto
+++ b/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;
 }