docs: updates to nested workflow docs (#13117)

www/apps/book/public/llms-full.txt

@@ -18840,15 +18840,17 @@ In this example, if the `actionThatThrowsError` step throws an error, the `moreA
 You can then access the error that occurred in that step as explained in the [Disable Error Throwing](#disable-error-throwing-in-workflow) section.
 
 
-# Execute Another Workflow
+# Execute Nested Workflows
 
-In this chapter, you'll learn how to execute a workflow in another.
+In this chapter, you'll learn how to execute a workflow in another workflow.
 
-## Execute in a Workflow
+## How to Execute a Workflow in Another?
 
-To execute a workflow in another, use the `runAsStep` method that every workflow has.
+In many cases, you may have a workflow that you want to re-use in another workflow. This is most common when you build custom workflows and you want to utilize Medusa's [existing workflows](https://docs.medusajs.com/resources/medusa-workflows-reference/index.html.md).
 
-For example:
+Executing a workflow within another is slightly different from how you usually execute a workflow. Instead of invoking the workflow, passing it the container, then running its `run` method, you use the `runAsStep` method of the workflow. This will pass the Medusa container and workflow context to the nested workflow.
+
+For example, to execute the [createProductsWorkflow](https://docs.medusajs.com/resources/references/medusa-workflows/createProductsWorkflow/index.html.md) in your custom workflow:
 
 ```ts highlights={workflowsHighlights} collapsibleLines="1-7" expandMoreButton="Show Imports"
 import {
@@ -18874,17 +18876,21 @@ const workflow = createWorkflow(
 )
 ```
 
-Instead of invoking the workflow and passing it the container, you use its `runAsStep` method and pass it an object as a parameter.
+The `runAsStep` method accepts an `input` property to pass input to the workflow.
 
-The object has an `input` property to pass input to the workflow.
+### Returned Data
+
+Notice that you don't need to use `await` when executing the nested workflow, as it's not a promise in this scenario.
+
+You also receive the workflow's output as a return value from the `runAsStep` method. This is different from the usual workflow response, where you receive the output in a `result` property.
 
 ***
 
-## Preparing Input Data
+## Prepare Input Data
 
-If you need to perform some data manipulation to prepare the other workflow's input data, use `transform` from the Workflows SDK.
+Since Medusa creates an internal representation of your workflow's constructor function, you can't manipulate data directly in the workflow constructor. You can learn more about this in the [Data Manipulation](https://docs.medusajs.com/learn/fundamentals/workflows/variable-manipulation/index.html.md) chapter.
 
-Learn about transform in [this chapter](https://docs.medusajs.com/learn/fundamentals/workflows/variable-manipulation/index.html.md).
+If you need to perform some data manipulation to prepare the nested workflow's input data, use `transform` from the Workflows SDK.
 
 For example:
 
@@ -18923,15 +18929,15 @@ const workflow = createWorkflow(
 )
 ```
 
-In this example, you use the `transform` function to prepend `Hello` to the title of the product. Then, you pass the result as an input to the `createProductsWorkflow`.
+In this example, you use the `transform` function to prepend `Hello` to the title of the product. Then, you pass the result as input to the `createProductsWorkflow`.
+
+Learn more about `transform` in the [Data Manipulation](https://docs.medusajs.com/learn/fundamentals/workflows/variable-manipulation/index.html.md) chapter.
 
 ***
 
 ## Run Workflow Conditionally
 
-To run a workflow in another based on a condition, use when-then from the Workflows SDK.
-
-Learn about when-then in [this chapter](https://docs.medusajs.com/learn/fundamentals/workflows/conditions/index.html.md).
+Similar to the [previous section](#prepare-input-data), you can't use conditional statements directly in the workflow constructor. Instead, you can use the `when-then` function from the Workflows SDK to run a workflow conditionally.
 
 For example:
 
@@ -18967,7 +18973,29 @@ const workflow = createWorkflow(
 )
 ```
 
-In this example, you use when-then to run the `createProductsWorkflow` only if `should_create` (passed in the `input`) is enabled.
+In this example, you use `when-then` to run the `createProductsWorkflow` only if `should_create` (passed in the `input`) is enabled.
+
+Learn more about `when-then` in the [When-Then Conditions](https://docs.medusajs.com/learn/fundamentals/workflows/conditions/index.html.md) chapter.
+
+***
+
+## Errors in Nested Workflows
+
+A nested workflow behaves similarly to a step in a workflow. So, if the nested workflow fails, it will throw an error that stops the parent workflow's execution and compensates previous steps.
+
+In addition, if another step fails after the nested workflow, the nested workflow's steps will be compensated as part of the compensation process.
+
+Learn more about handling errors in workflows in the [Error Handling](https://docs.medusajs.com/learn/fundamentals/workflows/errors/index.html.md) chapter.
+
+***
+
+## Nested Long-Running Workflows
+
+When you execute a long-running workflow within another workflow, the parent workflow becomes a long-running workflow as well.
+
+So, the parent workflow will wait for the nested workflow to finish before continuing its execution.
+
+Refer to the [Long-Running Workflows](https://docs.medusajs.com/learn/fundamentals/workflows/long-running-workflow/index.html.md) chapter for more information on how to handle long-running workflows.
 
 
 # Long-Running Workflows
@@ -19048,6 +19076,7 @@ A workflow is also considered long-running if:
 
 - One of its steps has its `async` configuration set to `true` and doesn't return a step response.
 - One of its steps has its `retryInterval` option set as explained in the [Retry Failed Steps chapter](https://docs.medusajs.com/learn/fundamentals/workflows/retry-failed-steps/index.html.md).
+- One of its [nested workflows](https://docs.medusajs.com/learn/fundamentals/workflows/execute-another-workflow/index.html.md) is a long-running workflow.
 
 ***