Skip to content

Commit 1ef70d5

Browse files
committed
edits
1 parent bf0caba commit 1ef70d5

11 files changed

+106
-413
lines changed

articles/azure-functions/durable/TOC.yml

Lines changed: 8 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -17,27 +17,22 @@
1717
- name: Quickstarts
1818
expanded: true
1919
items:
20-
- name: Create durable function - C#
21-
items:
22-
- name: In-process
23-
href: durable-functions-create-first-csharp.md
24-
displayName: get started, chaining
25-
- name: Isolated worker process
26-
href: durable-functions-isolated-create-first-csharp.md
27-
displayName: get started, chaining
28-
- name: Create durable function - JavaScript
20+
- name: Create a Durable Functions app - C#
21+
displayName: get started, chaining
22+
href: durable-functions-isolated-create-first-csharp.md
23+
- name: Create a Durable Functions app - JavaScript
2924
displayName: get started, chaining
3025
href: quickstart-js-vscode.md
31-
- name: Create durable function - TypeScript
26+
- name: Create a Durable Functions app - TypeScript
3227
displayName: get started, chaining
3328
href: quickstart-ts-vscode.md
34-
- name: Create durable function - Python
29+
- name: Create a Durable Functions app - Python
3530
displayName: get started, chaining
3631
href: quickstart-python-vscode.md
37-
- name: Create durable function - PowerShell
32+
- name: Create a Durable Functions app - PowerShell
3833
displayName: get started, chaining
3934
href: quickstart-powershell-vscode.md
40-
- name: Create durable function - Java
35+
- name: Create a Durable Functions app - Java
4136
displayName: get started, chaining
4237
href: quickstart-java.md
4338
- name: Configure storage provider - Netherite

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

Lines changed: 0 additions & 302 deletions
This file was deleted.

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

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: "Quickstart: Create a C# durable function (isolated worker)"
3-
description: Create and publish a C# durable function (isolated worker model) in Azure Functions by using Visual Studio or Visual Studio Code.
2+
title: "Quickstart: Create a C# Durable Functions app"
3+
description: Create and publish a C# Durable Functions app in Azure Functions by using Visual Studio or Visual Studio Code.
44
author: lilyjma
55
ms.topic: quickstart
66
ms.date: 06/05/2024
@@ -10,7 +10,7 @@ ms.devlang: csharp
1010
ms.custom: mode-other, devdivchpfy22, vscode-azure-extension-update-complete, devx-track-dotnet
1111
---
1212

13-
# Quickstart: Create a C# durable function (isolated worker model)
13+
# Quickstart: Create a C# Durable Functions app
1414

1515
Durable Functions is a feature of [Azure Functions](../functions-overview.md) that you can use to write stateful functions in a serverless environment. Durable Functions manages state, checkpoints, and restarts for you.
1616

@@ -22,9 +22,9 @@ To learn more about the two processes, see [Differences between in-process and i
2222

2323
::: zone pivot="code-editor-vscode"
2424

25-
In this quickstart, you use Visual Studio Code to locally create and test a "hello world" durable function. This function orchestrates and chains together calls to other functions. Then, you publish the function code in Azure. The tools you use are available via the Visual Studio Code [Azure Functions extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azurefunctions).
25+
In this quickstart, you use Visual Studio Code to locally create and test a "hello world" Durable Functions app. The function app orchestrates and chains together calls to other functions. Then, you publish the function code in Azure. The tools you use are available via the Visual Studio Code [Azure Functions extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azurefunctions).
2626

27-
:::image type="content" source="./media/durable-functions-create-first-csharp/functions-vscode-complete.png" alt-text="Screenshot of durable function code in Visual Studio Code.":::
27+
:::image type="content" source="./media/durable-functions-create-first-csharp/functions-vscode-complete.png" alt-text="Screenshot of Durable Functions app code in Visual Studio Code.":::
2828

2929
## Prerequisites
3030

@@ -76,7 +76,7 @@ Another file, *HelloOrchestration.cs*, contains the basic building blocks of a D
7676

7777
| Method | Description |
7878
| ----- | ----------- |
79-
| `HelloOrchestration` | Defines the durable function orchestration. In this case, the orchestration starts, creates a list, and then adds the result of three functions calls to the list. When the three function calls finish, it returns the list. |
79+
| `HelloOrchestration` | Defines the Durable Functions app orchestration. In this case, the orchestration starts, creates a list, and then adds the result of three functions calls to the list. When the three function calls finish, it returns the list. |
8080
| `SayHello` | A simple function app that returns *hello*. This function contains the business logic that is orchestrated. |
8181
| `HelloOrchestration_HttpStart` | An [HTTP-triggered function](../functions-bindings-http-webhook.md) that starts an instance of the orchestration and returns a *check status* response. |
8282

@@ -98,7 +98,7 @@ You can use [Azurite](../../storage/common/storage-use-azurite.md?tabs=visual-st
9898

9999
To install and start running the Azurite extension in Visual Studio Code, in the command palette, enter **Azurite: Start** and select Enter.
100100

101-
You can use other storage options for your durable function app. For more information about storage options and benefits, see [Durable Functions storage providers](durable-functions-storage-providers.md).
101+
You can use other storage options for your Durable Functions app. For more information about storage options and benefits, see [Durable Functions storage providers](durable-functions-storage-providers.md).
102102

103103
## Test the function locally
104104

@@ -117,13 +117,13 @@ Azure Functions Core Tools gives you the capability to run an Azure Functions pr
117117

118118
1. Use a tool like [Postman](https://www.getpostman.com/) or [cURL](https://curl.haxx.se/) to send an HTTP POST request to the URL endpoint.
119119

120-
The response is the HTTP function's initial result. It lets you know that the durable function orchestration started successfully. It doesn't yet display the end result of the orchestration. The response includes a few useful URLs.
120+
The response is the HTTP function's initial result. It lets you know that the Durable Functions app orchestration started successfully. It doesn't yet display the end result of the orchestration. The response includes a few useful URLs.
121121

122122
At this point, your breakpoint in the activity function should be hit because the orchestration has started. Step through it to get a response for the status of the orchestration.
123123

124124
1. Copy the URL value for `statusQueryGetUri`, paste it in your browser's address bar, and execute the request. Alternatively, you can also continue to use Postman to issue the GET request.
125125

126-
The request queries the orchestration instance for the status. You should see that the instance finished and that it includes the outputs or results of the durable function like in this example:
126+
The request queries the orchestration instance for the status. You should see that the instance finished and that it includes the outputs or results of the Durable Functions app like in this example:
127127

128128
```json
129129
{
@@ -139,7 +139,7 @@ Azure Functions Core Tools gives you the capability to run an Azure Functions pr
139139
```
140140

141141
> [!TIP]
142-
> Learn how you can observe the [replay behavior](./durable-functions-orchestrations.md#reliability) of a durable function through breakpoints.
142+
> Learn how you can observe the [replay behavior](./durable-functions-orchestrations.md#reliability) of a Durable Functions app through breakpoints.
143143

144144
1. To stop debugging, in Visual Studio Code, select Shift+F5.
145145

@@ -157,23 +157,23 @@ After you verify that the function runs correctly on your local computer, it's t
157157

158158
1. Paste the new URL for the HTTP request in your browser's address bar. You must get the same status response that you got when you tested locally when you use the published app.
159159

160-
The C# durable function app that you created and published by using Visual Studio Code is ready to use.
160+
The C# Durable Functions app that you created and published by using Visual Studio Code is ready to use.
161161

162162
## Clean up resources
163163

164164
If you no longer need the resources that you created to complete the quickstart, to avoid related costs in your Azure subscription, [delete the resource group](/azure/azure-resource-manager/management/delete-resource-group?tabs=azure-portal#delete-resource-group) and all related resources.
165165

166166
## Related content
167167

168-
* Learn about [common durable function patterns](durable-functions-overview.md#application-patterns).
168+
* Learn about [common Durable Functions app patterns](durable-functions-overview.md#application-patterns).
169169

170170
::: zone-end
171171

172172
::: zone pivot="code-editor-visualstudio"
173173

174-
In this quickstart, you use Visual Studio 2022 to locally create and test a "hello world" durable function that runs in the isolated worker process. The function orchestrates and chains together calls to other functions. Then, you publish the function code in Azure. The tools you use are available via the *Azure development workload* in Visual Studio 2022.
174+
In this quickstart, you use Visual Studio 2022 to locally create and test a "hello world" Durable Functions app that runs in the isolated worker process. The function orchestrates and chains together calls to other functions. Then, you publish the function code in Azure. The tools you use are available via the *Azure development workload* in Visual Studio 2022.
175175

176-
:::image type="content" source="./media/durable-functions-create-first-csharp/functions-vs-complete.png" alt-text="Screenshot of durable function code in Visual Studio 2019.":::
176+
:::image type="content" source="./media/durable-functions-create-first-csharp/functions-vs-complete.png" alt-text="Screenshot of Durable Functions app code in Visual Studio 2019.":::
177177

178178
## Prerequisites
179179

@@ -216,11 +216,11 @@ The Azure Functions template creates a project that you can publish to a functio
216216
> [!NOTE]
217217
> You can choose other storage options for your Durable Functions app. For more information, see [Durable Functions storage providers](durable-functions-storage-providers.md).
218218

219-
In your app folder, a file named *Function1.cs* contains three functions. The three functions are the basic building blocks of a durable function:
219+
In your app folder, a file named *Function1.cs* contains three functions. The three functions are the basic building blocks of a Durable Functions app:
220220

221221
| Method | Description |
222222
| ----- | ----------- |
223-
| `RunOrchestrator` | Defines the durable function orchestration. In this case, the orchestration starts, creates a list, and then adds the result of three functions calls to the list. When the three function calls finish, it returns the list. |
223+
| `RunOrchestrator` | Defines the Durable Functions app orchestration. In this case, the orchestration starts, creates a list, and then adds the result of three functions calls to the list. When the three function calls finish, it returns the list. |
224224
| `SayHello` | A simple function app that returns *hello*. This function contains the business logic that is orchestrated. |
225225
| `HttpStart` | An [HTTP-triggered function](../functions-bindings-http-webhook.md) that starts an instance of the orchestration and returns a *check status* response. |
226226

@@ -249,7 +249,7 @@ Azure Functions Core Tools gives you the capability to run an Azure Functions pr
249249

250250
1. Copy the URL value for `statusQueryGetUri`, paste it in your browser's address bar, and execute the request.
251251

252-
The request queries the orchestration instance for the status. You should see that the instance finished and that it includes the outputs or results of the durable function like in this example:
252+
The request queries the orchestration instance for the status. You should see that the instance finished and that it includes the outputs or results of the durable function, like in this example:
253253

254254
```json
255255
{
@@ -265,7 +265,7 @@ Azure Functions Core Tools gives you the capability to run an Azure Functions pr
265265
```
266266

267267
> [!TIP]
268-
> Learn how you can observe the [replay behavior](./durable-functions-orchestrations.md#reliability) of a durable function through breakpoints.
268+
> Learn how you can observe the [replay behavior](./durable-functions-orchestrations.md#reliability) of a Durable Functions app through breakpoints.
269269

270270
1. To stop debugging, select Shift+F5.
271271

@@ -287,14 +287,14 @@ You must have a function app in your Azure subscription before you publish your
287287

288288
1. Paste the new URL for the HTTP request in your browser's address bar. When you test the published app, you must get the same status response that you got when you tested locally.
289289

290-
The C# durable function app that you created and published by using Visual Studio is ready to use.
290+
The C# Durable Functions app that you created and published by using Visual Studio is ready to use.
291291

292292
## Clean up resources
293293

294294
If you no longer need the resources that you created to complete the quickstart, to avoid related costs in your Azure subscription, [delete the resource group](/azure/azure-resource-manager/management/delete-resource-group?tabs=azure-portal#delete-resource-group) and all related resources.
295295

296296
## Related content
297297

298-
* Learn about [common durable function patterns](durable-functions-overview.md#application-patterns).
298+
* Learn about [common Durable Functions app patterns](durable-functions-overview.md#application-patterns).
299299

300300
::: zone-end

articles/azure-functions/durable/index.yml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -40,11 +40,11 @@ landingContent:
4040
linkLists:
4141
- linkListType: quickstart
4242
links:
43-
- text: Create durable functions (C#)
44-
url: durable-functions-create-first-csharp.md
45-
- text: Create your first function (JavaScript)
43+
- text: Create a Durable Functions app (C#)
44+
url: durable-functions-isolated-create-first-csharp.md
45+
- text: Create a Durable Functions app (JavaScript)
4646
url: quickstart-js-vscode.md
47-
- text: Create your first function (Python)
47+
- text: Create a Durable Functions app (Python)
4848
url: quickstart-python-vscode.md
4949
- linkListType: learn
5050
links:

articles/azure-functions/durable/quickstart-java.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: "Quickstart: Create a Java durable function"
3-
description: Create and publish a Java durable function in Azure Functions. Choose manual setup, Maven, or Visual Studio Code.
2+
title: "Quickstart: Create a Java Durable Functions app"
3+
description: Create and publish a Java Durable Functions app in Azure Functions. Choose manual setup, Maven, or Visual Studio Code.
44
author: lilyjma
55
ms.topic: quickstart
66
ms.date: 12/12/2022
@@ -10,13 +10,13 @@ ms.custom: mode-api, devx-track-extended-java
1010
zone_pivot_groups: create-java-durable-options
1111
---
1212

13-
# Quickstart: Create a Java durable function
13+
# Quickstart: Create a Java Durable Functions app
1414

1515
Durable Functions is a feature of [Azure Functions](../functions-overview.md) that you can use to write stateful functions in a serverless environment. Durable Functions manages state, checkpoints, and restarts for you.
1616

17-
In this quickstart, you create and test a "hello world" durable function app in Java.
17+
In this quickstart, you create and test a "hello world" Durable Functions app in Java.
1818

19-
The most basic durable function app has three functions:
19+
The most basic Durable Functions app has three functions:
2020

2121
* **Orchestrator function**: A workflow that orchestrates other functions.
2222
* **Activity function**: A function that is called by the orchestrator function, performs work, and optionally returns a value.
@@ -216,7 +216,7 @@ public class DurableFunctionsSample {
216216

217217
## Create a local project by using the Maven command
218218

219-
Run the following command to generate a project that contains the basic functions of a durable function app:
219+
Run the following command to generate a project that contains the basic functions of a Durable Functions app:
220220

221221
# [Bash](#tab/bash)
222222

@@ -248,7 +248,7 @@ At the prompts, provide the following information:
248248
| **package** | Enter **com.function**. |
249249
| **Y** | Enter **Y** and select Enter to confirm. |
250250

251-
Now you have a local project that has the three functions that are in a basic durable function app.
251+
Now you have a local project that has the three functions that are in a basic Durable Functions app.
252252

253253
Check to ensure that `com.microsoft:durabletask-azure-functions` is set as a dependency in your _pom.xml_ file.
254254

@@ -292,7 +292,7 @@ Durable Functions needs a storage provider to store runtime state. You can set A
292292
| **Select the build tool for Java project** | Select **Maven**. |
293293
| **Select how you would like to open your project** | Select **Open in new window**. |
294294

295-
You now have a project that has an example HTTP function. You can remove this function if you'd like to, because you add the basic functions of a durable function app in the next step.
295+
You now have a project that has an example HTTP function. You can remove this function if you'd like to, because you add the basic functions of a Durable Functions app in the next step.
296296

297297
## Add functions to the project
298298

@@ -310,7 +310,7 @@ You now have a project that has an example HTTP function. You can remove this fu
310310

311311
1. In the dialog, choose **Select storage account** to set up a storage account, and then follow the prompts.
312312

313-
You should now have the three basic functions generated for a durable function app.
313+
You should now have the three basic functions generated for a Durable Functions app.
314314

315315
## Configure pom.xml and host.json
316316

@@ -371,7 +371,7 @@ Azure Functions Core Tools gives you the capability to run an Azure Functions pr
371371

372372
1. Copy the URL value for `statusQueryGetUri`, paste it in your browser's address bar, and execute the request. Alternatively, you can continue to use Postman to issue the GET request.
373373

374-
The request queries the orchestration instance for the status. You should see that the instance finished and that it includes the outputs or results of the durable function like in this example:
374+
The request queries the orchestration instance for the status. You should see that the instance finished and that it includes the outputs or results of the durable function, like in this example:
375375

376376
```json
377377
{

0 commit comments

Comments
 (0)