improve comment

Author: carlydf

openapi/openapiv2.json

@@ -15576,7 +15576,7 @@
         },
         "previousRunVersioningInfo": {
           "$ref": "#/definitions/v1SourceWorkflowVersioningInfo",
-          "description": "When present, this workflow is part of a chain, and the previous workflow in the chain was versioned.\nThe `initiator` field of this event specifies why this new workflow was initiated.\n\nIf initiated by a workflow ContinueAsNew, and the previous workflow's effective behavior is PINNED,\nand the new workflow's Task Queue belongs to the previous workflow's Version, the new workflow will\ninherit the previous workflow's version.\n\nIf initiated by a workflow retry on a root workflow execution, the new workflow will not inherit the\nprevious workflow's Version, but, if the previous workflow has a Pinned parent or is part of a Pinned\nContinueAsNew chain, then the new workflow will inherit the version of the existing tree or chain.\n\nIf initiated by a workflow Cron, the new workflow will never inherit the previous workflow's Version."
+          "description": "When present, this workflow is part of a chain, and the previous workflow in the chain was versioned.\nThe `initiator` field of this event specifies why this new workflow was initiated.\n\nIf initiated by a workflow ContinueAsNew, and the previous workflow's effective behavior is PINNED,\nand the new workflow's Task Queue belongs to the previous workflow's Version, the new workflow will\ninherit the previous workflow's version.\n\nIf initiated by a workflow retry on a root workflow execution, the new workflow will not inherit the\nprevious workflow's Version, but, if the retried workflow has a Pinned parent or is part of a Pinned\nContinueAsNew chain, then the new workflow will inherit the version of the existing tree or chain\n(see `ExecutionInfo.versioning_info.source_workflow_versioning_info`).\n\nIf initiated by a workflow Cron, the new workflow will never inherit the previous workflow's Version."
         }
       },
       "title": "Always the first event in workflow history"

openapi/openapiv3.yaml

@@ -13122,8 +13122,9 @@ components:
              inherit the previous workflow's version.
 
              If initiated by a workflow retry on a root workflow execution, the new workflow will not inherit the
-             previous workflow's Version, but, if the previous workflow has a Pinned parent or is part of a Pinned
-             ContinueAsNew chain, then the new workflow will inherit the version of the existing tree or chain.
+             previous workflow's Version, but, if the retried workflow has a Pinned parent or is part of a Pinned
+             ContinueAsNew chain, then the new workflow will inherit the version of the existing tree or chain
+             (see `ExecutionInfo.versioning_info.source_workflow_versioning_info`).
 
              If initiated by a workflow Cron, the new workflow will never inherit the previous workflow's Version.
       description: Always the first event in workflow history

temporal/api/history/v1/message.proto

@@ -152,8 +152,9 @@ message WorkflowExecutionStartedEventAttributes {
         // inherit the previous workflow's version.
         //
         // If initiated by a workflow retry on a root workflow execution, the new workflow will not inherit the
-        // previous workflow's Version, but, if the previous workflow has a Pinned parent or is part of a Pinned
-        // ContinueAsNew chain, then the new workflow will inherit the version of the existing tree or chain.
+        // previous workflow's Version, but, if the retried workflow has a Pinned parent or is part of a Pinned
+        // ContinueAsNew chain, then the new workflow will inherit the version of the existing tree or chain
+        // (see `ExecutionInfo.versioning_info.source_workflow_versioning_info`).
         //
         // If initiated by a workflow Cron, the new workflow will never inherit the previous workflow's Version.
         temporal.api.workflow.v1.SourceWorkflowVersioningInfo previous_run_versioning_info = 38;