Merge pull request #280366 from ktoliver/266456

[AQ] edit pass of Durable Functions quickstarts (work item 266456)

Author: ShawnJackson

.openpublishing.redirection.json

@@ -78,6 +78,7 @@
     {
       "source_path": "articles/expressroute/expressroute-howto-set-global-reach-cli.md",
       "redirect_url": "/previous-versions/azure/expressroute/expressroute-howto-set-global-reach-cli",
+      "redirect_document_id": false
     },
     {
       "source_path": "articles/digital-twins/how-to-integrate-maps.md",
@@ -4402,6 +4403,11 @@
             "redirect_url": "/azure/azure-functions",
             "redirect_document_id": false
         },
+        {
+            "source_path_from_root": "/articles/azure-functions/durable/durable-functions-create-first-csharp.md",
+            "redirect_url": "/azure/azure-functions/durable/durable-functions-isolated-create-first-csharp.md",
+            "redirect_document_id": false
+        },
         {
             "source_path_from_root": "/articles/twilio-dotnet-how-to-use-for-voice-sms.md",
             "redirect_url": "https://www.twilio.com/docs/usage/tutorials/serverless-webhooks-azure-functions-and-csharp",

articles/azure-functions/durable/TOC.yml

@@ -17,34 +17,29 @@
 - name: Quickstarts
   expanded: true
   items:
-  - name: Create durable function - C#
-    items: 
-      - name: In-process
-        href: durable-functions-create-first-csharp.md
-        displayName: get started, chaining
-      - name: Isolated worker process
-        href: durable-functions-isolated-create-first-csharp.md
-        displayName: get started, chaining
-  - name: Create durable function - JavaScript
+  - name: Create a Durable Functions app - C#
+    displayName: get started, chaining
+    href: durable-functions-isolated-create-first-csharp.md
+  - name: Create a Durable Functions app - JavaScript
     displayName: get started, chaining
     href: quickstart-js-vscode.md
-  - name: Create durable function - TypeScript
+  - name: Create a Durable Functions app - TypeScript
     displayName: get started, chaining
     href: quickstart-ts-vscode.md
-  - name: Create durable function - Python
+  - name: Create a Durable Functions app - Python
     displayName: get started, chaining
     href: quickstart-python-vscode.md
-  - name: Create durable function - PowerShell
+  - name: Create a Durable Functions app - PowerShell
     displayName: get started, chaining
     href: quickstart-powershell-vscode.md
-  - name: Create durable function - Java
+  - name: Create a Durable Functions app - Java
     displayName: get started, chaining
     href: quickstart-java.md
-  - name: Configure storage provider - Netherite
+  - name: Configure a storage provider - Netherite
     href: quickstart-netherite.md
-  - name: Configure storage provider - MSSQL
+  - name: Configure a storage provider - MSSQL
     href: quickstart-mssql.md
-  - name: Configure Durable Functions with Microsoft Entra ID
+  - name: Authenticate a Durable Functions app
     href: durable-functions-configure-durable-functions-with-credentials.md   
 - name: Tutorials
   items:

articles/azure-functions/durable/durable-functions-configure-durable-functions-with-credentials.md

@@ -15,7 +15,7 @@ The [Durable Functions](durable-functions-overview.md) extension for Azure Funct
 
 > [!NOTE]
 > 
-> * If you are developing durable functions in C#, you should instead consider [Visual Studio 2019 development](durable-functions-create-first-csharp.md).
+> * If you are developing durable functions in C#, you should instead consider [Visual Studio 2019 development](durable-functions-isolated-create-first-csharp.md).
 > * If you are developing durable functions in JavaScript, you should instead consider [Visual Studio Code development](./quickstart-js-vscode.md).
 
 ## Create a function app

articles/azure-functions/durable/durable-functions-create-first-csharp.md

@@ -16,7 +16,7 @@ The monitor pattern refers to a flexible *recurring* process in a workflow - for
 
 # [C#](#tab/csharp)
 
-* [Complete the quickstart article](durable-functions-create-first-csharp.md)
+* [Complete the quickstart article](durable-functions-isolated-create-first-csharp.md)
 * [Clone or download the samples project from GitHub](https://github.com/Azure/azure-functions-durable-extension/tree/main/samples/precompiled)
 
 # [JavaScript](#tab/javascript)
@@ -30,7 +30,7 @@ The monitor pattern refers to a flexible *recurring* process in a workflow - for
 
 This sample monitors a location's current weather conditions and alerts a user by SMS when the skies are clear. You could use a regular timer-triggered function to check the weather and send alerts. However, one problem with this approach is **lifetime management**. If only one alert should be sent, the monitor needs to disable itself after clear weather is detected. The monitoring pattern can end its own execution, among other benefits:
 
-* Monitors run on intervals, not schedules: a timer trigger *runs* every hour; a monitor *waits* one hour between actions. A monitor's actions will not overlap unless specified, which can be important for long-running tasks.
+* Monitors run on intervals, not schedules: a timer trigger *runs* every hour; a monitor *waits* one hour between actions. A monitor's actions won't overlap unless specified, which can be important for long-running tasks.
 * Monitors can have dynamic intervals: the wait time can change based on some condition.
 * Monitors can terminate when some condition is met or be terminated by another process.
 * Monitors can take parameters. The sample shows how the same weather-monitoring process can be applied to any requested location and phone number.
@@ -47,7 +47,7 @@ This sample monitors a location's current weather conditions and alerts a user b
 
 This sample involves using the Weather Underground API to check current weather conditions for a location.
 
-The first thing you need is a Weather Underground account. You can create one for free at [https://www.wunderground.com/signup](https://www.wunderground.com/signup). Once you have an account, you will need to acquire an API key. You can do so by visiting [https://www.wunderground.com/weather/api](https://www.wunderground.com/weather/api/?MR=1), then selecting Key Settings. The Stratus Developer plan is free and sufficient to run this sample.
+The first thing you need is a Weather Underground account. You can create one for free at [https://www.wunderground.com/signup](https://www.wunderground.com/signup). Once you have an account, you need to acquire an API key. You can do so by visiting [https://www.wunderground.com/weather/api](https://www.wunderground.com/weather/api/?MR=1), then selecting Key Settings. The Stratus Developer plan is free and sufficient to run this sample.
 
 Once you have an API key, add the following **app setting** to your function app.
 
@@ -69,30 +69,30 @@ This article explains the following functions in the sample app:
 
 [!code-csharp[Main](~/samples-durable-functions/samples/precompiled/Monitor.cs?range=41-78,97-115)]
 
-The orchestrator requires a location to monitor and a phone number to send a message to when the whether becomes clear at the location. This data is passed to the orchestrator as a strongly typed `MonitorRequest` object.
+The orchestrator requires a location to monitor and a phone number to send a message to when the weather becomes clear at the location. This data is passed to the orchestrator as a strongly typed `MonitorRequest` object.
 
 # [JavaScript](#tab/javascript)
 
 The **E3_Monitor** function uses the standard *function.json* for orchestrator functions.
 
 :::code language="javascript" source="~/azure-functions-durable-js/samples/E3_Monitor/function.json":::
 
-Here is the code that implements the function:
+Here's the code that implements the function:
 
 :::code language="javascript" source="~/azure-functions-durable-js/samples/E3_Monitor/index.js":::
 
 ---
 
 This orchestrator function performs the following actions:
 
-1. Gets the **MonitorRequest** consisting of the *location* to monitor and the *phone number* to which it will send an SMS notification.
+1. Gets the **MonitorRequest** consisting of the *location* to monitor and the *phone number* to which it sends an SMS notification.
 2. Determines the expiration time of the monitor. The sample uses a hard-coded value for brevity.
 3. Calls **E3_GetIsClear** to determine whether there are clear skies at the requested location.
 4. If the weather is clear, calls **E3_SendGoodWeatherAlert** to send an SMS notification to the requested phone number.
 5. Creates a durable timer to resume the orchestration at the next polling interval. The sample uses a hard-coded value for brevity.
 6. Continues running until the current UTC time passes the monitor's expiration time, or an SMS alert is sent.
 
-Multiple orchestrator instances can run simultaneously by calling the orchestrator function multiple times. The location to monitor and the phone number to send an SMS alert to can be specified. Finally, do note that the orchestrator function is *not* running while waiting for the timer, so you will not get charged for it.
+Multiple orchestrator instances can run simultaneously by calling the orchestrator function multiple times. The location to monitor and the phone number to send an SMS alert to can be specified. Finally, do note that the orchestrator function isn't* running while waiting for the timer, so you won't get charged for it.
 ### E3_GetIsClear activity function
 
 As with other samples, the helper activity functions are regular functions that use the `activityTrigger` trigger binding. The **E3_GetIsClear** function gets the current weather conditions using the Weather Underground API and determines whether the sky is clear.
@@ -107,7 +107,7 @@ The *function.json* is defined as follows:
 
 :::code language="javascript" source="~/azure-functions-durable-js/samples/E3_GetIsClear/function.json":::
 
-And here is the implementation.
+And here's the implementation.
 
 :::code language="javascript" source="~/azure-functions-durable-js/samples/E3_GetIsClear/index.js":::
 
@@ -130,7 +130,7 @@ Its *function.json* is simple:
 
 :::code language="javascript" source="~/azure-functions-durable-js/samples/E3_SendGoodWeatherAlert/function.json":::
 
-And here is the code that sends the SMS message:
+And here's the code that sends the SMS message:
 
 :::code language="javascript" source="~/azure-functions-durable-js/samples/E3_SendGoodWeatherAlert/index.js":::
 
@@ -157,7 +157,7 @@ RetryAfter: 10
 {"id": "f6893f25acf64df2ab53a35c09d52635", "statusQueryGetUri": "https://{host}/runtime/webhooks/durabletask/instances/f6893f25acf64df2ab53a35c09d52635?taskHub=SampleHubVS&connection=Storage&code={systemKey}", "sendEventPostUri": "https://{host}/runtime/webhooks/durabletask/instances/f6893f25acf64df2ab53a35c09d52635/raiseEvent/{eventName}?taskHub=SampleHubVS&connection=Storage&code={systemKey}", "terminatePostUri": "https://{host}/runtime/webhooks/durabletask/instances/f6893f25acf64df2ab53a35c09d52635/terminate?reason={text}&taskHub=SampleHubVS&connection=Storage&code={systemKey}"}
 ```
 
-The **E3_Monitor** instance starts and queries the current weather conditions for the requested location. If the weather is clear, it calls an activity function to send an alert; otherwise, it sets a timer. When the timer expires, the orchestration will resume.
+The **E3_Monitor** instance starts and queries the current weather conditions for the requested location. If the weather is clear, it calls an activity function to send an alert; otherwise, it sets a timer. When the timer expires, the orchestration resumes.
 
 You can see the orchestration's activity by looking at the function logs in the Azure Functions portal.
 
@@ -177,15 +177,15 @@ You can see the orchestration's activity by looking at the function logs in the
 2018-03-01T01:14:54.030 Function completed (Success, Id=561d0c78-ee6e-46cb-b6db-39ef639c9a2c, Duration=62ms)
 ```
 
-The orchestration completes once its timeout is reached or clear skies are detected. You can also use the `terminate` API inside another function or invoke the **terminatePostUri** HTTP POST webhook referenced in the 202 response above. To use the webhook, replace `{text}` with the reason for the early termination. The HTTP POST URL will look roughly as follows:
+The orchestration completes once its timeout is reached or clear skies are detected. You can also use the `terminate` API inside another function or invoke the **terminatePostUri** HTTP POST webhook referenced in the preceding 202 response. To use the webhook, replace `{text}` with the reason for the early termination. The HTTP POST URL looks roughly as follows:
 
 ```
 POST https://{host}/runtime/webhooks/durabletask/instances/f6893f25acf64df2ab53a35c09d52635/terminate?reason=Because&taskHub=SampleHubVS&connection=Storage&code={systemKey}
 ```
 
 ## Next steps
 
-This sample has demonstrated how to use Durable Functions to monitor an external source's status using [durable timers](durable-functions-timers.md) and conditional logic. The next sample shows how to use external events and [durable timers](durable-functions-timers.md) to handle human interaction.
+This sample demonstrates how to use Durable Functions to monitor an external source's status using [durable timers](durable-functions-timers.md) and conditional logic. The next sample shows how to use external events and [durable timers](durable-functions-timers.md) to handle human interaction.
 
 > [!div class="nextstepaction"]
-> [Run the human interaction sample](durable-functions-phone-verification.md)
+> [Run the human interaction sample](durable-functions-phone-verification.md)

articles/azure-functions/durable/durable-functions-create-portal.md

@@ -38,7 +38,7 @@ Durable Functions is designed to work with all Azure Functions programming langu
 > This article uses tabs to support multiple versions of the Python programming model. The v2 model is generally available and is designed to provide a more code-centric way for authoring functions through decorators. For more details about how the v2 model works, refer to the [Azure Functions Python developer guide](../functions-reference-python.md). 
 ::: zone-end
 
-Like Azure Functions, there are templates to help you develop Durable Functions using [Visual Studio](durable-functions-create-first-csharp.md), [Visual Studio Code](quickstart-js-vscode.md), and the [Azure portal](durable-functions-create-portal.md).
+Like Azure Functions, there are templates to help you develop Durable Functions using [Visual Studio](durable-functions-isolated-create-first-csharp.md), [Visual Studio Code](quickstart-js-vscode.md), and the [Azure portal](durable-functions-create-portal.md).
 
 ## Application patterns
 
@@ -479,7 +479,7 @@ The async HTTP API pattern addresses the problem of coordinating the state of lo
 
 ![A diagram of the HTTP API pattern](./media/durable-functions-concepts/async-http-api.png)
 
-Durable Functions provides **built-in support** for this pattern, simplifying or even removing the code you need to write to interact with long-running function executions. For example, the Durable Functions quickstart samples ([C#](durable-functions-create-first-csharp.md), [JavaScript](quickstart-js-vscode.md), [TypeScript](quickstart-ts-vscode.md), [Python](quickstart-python-vscode.md), [PowerShell](quickstart-powershell-vscode.md), and [Java](quickstart-java.md)) show a simple REST command that you can use to start new orchestrator function instances. After an instance starts, the extension exposes webhook HTTP APIs that query the orchestrator function status. 
+Durable Functions provides **built-in support** for this pattern, simplifying or even removing the code you need to write to interact with long-running function executions. For example, the Durable Functions quickstart samples ([C#](durable-functions-isolated-create-first-csharp.md), [JavaScript](quickstart-js-vscode.md), [TypeScript](quickstart-ts-vscode.md), [Python](quickstart-python-vscode.md), [PowerShell](quickstart-powershell-vscode.md), and [Java](quickstart-java.md)) show a simple REST command that you can use to start new orchestrator function instances. After an instance starts, the extension exposes webhook HTTP APIs that query the orchestrator function status. 
 
 The following example shows REST commands that start an orchestrator and query its status. For clarity, some protocol details are omitted from the example.
 
@@ -1501,7 +1501,7 @@ Durable Functions are billed the same as Azure Functions. For more information,
 
 You can get started with Durable Functions in under 10 minutes by completing one of these language-specific quickstart tutorials:
 
-* [C# using Visual Studio 2019](durable-functions-create-first-csharp.md)
+* [C# using Visual Studio 2019](durable-functions-isolated-create-first-csharp.md)
 * [JavaScript using Visual Studio Code](quickstart-js-vscode.md)
 * [TypeScript using Visual Studio Code](quickstart-ts-vscode.md)
 * [Python using Visual Studio Code](quickstart-python-vscode.md)

articles/azure-functions/durable/durable-functions-isolated-create-first-csharp.md

@@ -12,7 +12,7 @@ ms.custom: devx-track-js
 
 # Function chaining in Durable Functions - Hello sequence sample
 
-Function chaining refers to the pattern of executing a sequence of functions in a particular order. Often the output of one function needs to be applied to the input of another function. This article describes the chaining sequence that you create when you complete the Durable Functions quickstart ([C#](durable-functions-create-first-csharp.md),  [JavaScript](quickstart-js-vscode.md), [TypeScript](quickstart-ts-vscode.md), [Python](quickstart-python-vscode.md), [PowerShell](quickstart-powershell-vscode.md), or [Java](quickstart-java.md)). For more information about Durable Functions, see [Durable Functions overview](durable-functions-overview.md).
+Function chaining refers to the pattern of executing a sequence of functions in a particular order. Often the output of one function needs to be applied to the input of another function. This article describes the chaining sequence that you create when you complete the Durable Functions quickstart ([C#](durable-functions-isolated-create-first-csharp.md),  [JavaScript](quickstart-js-vscode.md), [TypeScript](quickstart-ts-vscode.md), [Python](quickstart-python-vscode.md), [PowerShell](quickstart-powershell-vscode.md), or [Java](quickstart-java.md)). For more information about Durable Functions, see [Durable Functions overview](durable-functions-overview.md).
 
 [!INCLUDE [durable-functions-prerequisites](../../../includes/durable-functions-prerequisites.md)]
 

articles/azure-functions/durable/durable-functions-monitor.md

@@ -57,7 +57,7 @@ In addition to triggering orchestrator or entity functions, the *durable client*
 
 ## Next steps
 
-To get started, create your first durable function in [C#](durable-functions-create-first-csharp.md), [JavaScript](quickstart-js-vscode.md), [Python](quickstart-python-vscode.md), [PowerShell](quickstart-powershell-vscode.md), or [Java](quickstart-java.md).
+To get started, create your first durable function in [C#](durable-functions-isolated-create-first-csharp.md), [JavaScript](quickstart-js-vscode.md), [Python](quickstart-python-vscode.md), [PowerShell](quickstart-powershell-vscode.md), or [Java](quickstart-java.md).
 
 > [!div class="nextstepaction"]
 > [Read more about Durable Functions orchestrations](durable-functions-orchestrations.md)