From 963a2018dee902def4c79183f1790cca52c574c3 Mon Sep 17 00:00:00 2001 From: Hannah Hunter Date: Thu, 9 Feb 2023 10:14:37 -0600 Subject: [PATCH] mark review Signed-off-by: Hannah Hunter --- .../workflow/howto-author-workflow.md | 4 ++-- .../en/getting-started/quickstarts/_index.md | 2 +- .../quickstarts/workflow-quickstart.md | 19 +++++++++++++------ 3 files changed, 16 insertions(+), 9 deletions(-) diff --git a/daprdocs/content/en/developing-applications/building-blocks/workflow/howto-author-workflow.md b/daprdocs/content/en/developing-applications/building-blocks/workflow/howto-author-workflow.md index e7d30ea53..10392e70c 100644 --- a/daprdocs/content/en/developing-applications/building-blocks/workflow/howto-author-workflow.md +++ b/daprdocs/content/en/developing-applications/building-blocks/workflow/howto-author-workflow.md @@ -24,7 +24,7 @@ Dapr Workflow logic is implemented using general purpose programming languages, - Use debuggers and examine local variables - Write unit tests for your workflows, just like any other part of your application logic -The Dapr sidecar doesn’t load any workflow definitions. Rather, the sidecar simply drives the execution of the workflows, leaving all other details to the application layer. +The Dapr sidecar doesn’t load any workflow definitions. Rather, the sidecar simply drives the execution of the workflows, leaving all the workflow activities to be part of the application. ## Write the workflow activities @@ -170,4 +170,4 @@ Now that you've authored a workflow, learn how to manage it. ## Related links - [Workflow overview]({{< ref workflow-overview.md >}}) - [Workflow API reference]({{< ref workflow_api.md >}}) -- Learn more about [how to manage workflows with the .NET SDK](todo) and try out [the .NET example](https://github.com/dapr/dotnet-sdk/tree/master/examples/Workflow) +- [Try out the .NET example](https://github.com/dapr/dotnet-sdk/tree/master/examples/Workflow) diff --git a/daprdocs/content/en/getting-started/quickstarts/_index.md b/daprdocs/content/en/getting-started/quickstarts/_index.md index 575b9c4c5..e73d9cbcf 100644 --- a/daprdocs/content/en/getting-started/quickstarts/_index.md +++ b/daprdocs/content/en/getting-started/quickstarts/_index.md @@ -29,4 +29,4 @@ Hit the ground running with our Dapr quickstarts, complete with code samples aim | [Secrets Management]({{< ref secrets-quickstart.md >}}) | Securely fetch secrets. | | [Configuration]({{< ref configuration-quickstart.md >}}) | Get configuration items and subscribe for configuration updates. | | [Resiliency]({{< ref resiliency >}}) | Define and apply fault-tolerance policies to your Dapr API requests. | -| [Workflow]({{< ref workflow-quickstart.md >}}) | Orchestrate logic for messaging, state management, and failure handling. | +| [Workflow]({{< ref workflow-quickstart.md >}}) | Orchestrate business workflow activities in long running, fault-tolerant, stateful applications. | diff --git a/daprdocs/content/en/getting-started/quickstarts/workflow-quickstart.md b/daprdocs/content/en/getting-started/quickstarts/workflow-quickstart.md index 6196fb8b0..9faa3e830 100644 --- a/daprdocs/content/en/getting-started/quickstarts/workflow-quickstart.md +++ b/daprdocs/content/en/getting-started/quickstarts/workflow-quickstart.md @@ -12,7 +12,7 @@ The workflow building block is currently in **alpha**. Let's take a look at the Dapr [Workflow building block]({{< ref workflow >}}). In this Quickstart, you'll create a simple console application to demonstrate Dapr's workflow programming model and the workflow management APIs. -The `order-processor` console app starts and manages the lifecycle of the `OrderProcessingWorkflow` workflow that stores and retrieves data in a Dapr state store. The workflow consists of four workflow activities, or tasks: +The `order-processor` console app starts and manages the lifecycle of the `OrderProcessingWorkflow` workflow that stores and retrieves data in a state store. The workflow consists of four workflow activities, or tasks: - `NotifyActivity`: Utilizes a logger to print out messages throughout the workflow - `ReserveInventoryActivity`: Checks the state store to ensure that there is enough inventory for the purchase - `ProcessPaymentActivity`: Processes and authorizes the payment @@ -20,9 +20,9 @@ The `order-processor` console app starts and manages the lifecycle of the `Order In this guide, you'll: -- Run the order processor application. +- Run the `order-processor` application. - Start the workflow and watch the workflow activites/tasks execute. -- Unpack the workflow logic and the workflow activities and how they're represented in the code. +- Review the workflow logic and the workflow activities and how they're represented in the code. @@ -72,7 +72,7 @@ In the terminal, start the order processor app alongside a Dapr sidecar: dapr run --app-id order-processor dotnet run ``` -This starts the `order-processor` ID and triggers the workflow activities. +This starts the `order-processor` app with unique workflow ID and runs the workflow activities. Expected output: @@ -106,7 +106,7 @@ Expected output: ### What happened? -When you ran `dapr run dotnet run`: +When you ran `dapr run --app-id order-processor dotnet run`: 1. A unique order ID for the workflow is generated (in the above example, `6d2abcc9`) and the workflow is scheduled. 1. The `NotifyActivity` workflow activity sends a notification saying an order for 10 cars has been received. @@ -120,7 +120,7 @@ When you ran `dapr run dotnet run`: #### `order-processor/Program.cs` In the application's program file: -- The unique order ID is generated +- The unique workflow order ID is generated - The workflow is scheduled - The workflow status is retrieved - The workflow and the workflow activities it invokes are registered @@ -258,6 +258,13 @@ The `Activities` directory holds the four workflow activities used by the workfl {{< /tabs >}} +## Watch the demo + +Watch [this video to walk through the workflow .NET demo](https://youtu.be/BxiKpEmchgQ?t=2564): + + + + ## Tell us what you think! We're continuously working to improve our Quickstart examples and value your feedback. Did you find this Quickstart helpful? Do you have suggestions for improvement?