Merge pull request #232074 from ejizba/ej/v3v4choices

American-Dipper · web-flow · commit 54b6bb54b8f8 · 2023-03-24T16:55:42.000-07:00
Clean up notes about choice of v3/v4 node.js model
diff --git a/articles/azure-functions/create-first-function-cli-node.md b/articles/azure-functions/create-first-function-cli-node.md
@@ -12,10 +12,9 @@ zone_pivot_groups: functions-nodejs-model
 
 In this article, you use command-line tools to create a JavaScript function that responds to HTTP requests. After testing the code locally, you deploy it to the serverless environment of Azure Functions.
 
->[!NOTE]
->The v4 programming model for authoring Functions in Node.js is currently in Preview. Compared to the current v3 model, the v4 model is designed to have a more idiomatic and intuitive experience for JavaScript and TypeScript developers. To learn more, see the [Developer Reference Guide](functions-reference-node.md).
+[!INCLUDE [functions-nodejs-model-pivot-description](../../includes/functions-nodejs-model-pivot-description.md)]
 
-Use the selector at the top to choose the programming model of your choice for completing this quickstart. Note that completion will incur a small cost of a few USD cents or less in your Azure account.
+Note that completion will incur a small cost of a few USD cents or less in your Azure account.
 
 There is also a [Visual Studio Code-based version](create-first-function-vs-code-node.md) of this article.
 
diff --git a/articles/azure-functions/create-first-function-cli-typescript.md b/articles/azure-functions/create-first-function-cli-typescript.md
@@ -12,10 +12,9 @@ zone_pivot_groups: functions-nodejs-model
 
 In this article, you use command-line tools to create a TypeScript function that responds to HTTP requests. After testing the code locally, you deploy it to the serverless environment of Azure Functions.
 
->[!NOTE]
->The v4 programming model for authoring Functions in Node.js is currently in Preview. Compared to the current v3 model, the v4 model is designed to have a more idiomatic and intuitive experience for JavaScript and TypeScript developers. To learn more, see the [Developer Reference Guide](functions-reference-node.md).
+[!INCLUDE [functions-nodejs-model-pivot-description](../../includes/functions-nodejs-model-pivot-description.md)]
 
-Use the selector at the top to choose the programming model of your choice for completing this quickstart. Note that completion will incur a small cost of a few USD cents or less in your Azure account.
+Note that completion will incur a small cost of a few USD cents or less in your Azure account.
 
 There's also a [Visual Studio Code-based version](create-first-function-vs-code-typescript.md) of this article.
 
diff --git a/articles/azure-functions/create-first-function-vs-code-node.md b/articles/azure-functions/create-first-function-vs-code-node.md
@@ -16,10 +16,9 @@ zone_pivot_groups: functions-nodejs-model
 
 Use Visual Studio Code to create a JavaScript function that responds to HTTP requests. Test the code locally, then deploy it to the serverless environment of Azure Functions.
 
->[!NOTE]
->The v4 programming model for authoring Functions in Node.js is currently in Preview. Compared to the current v3 model, the v4 model is designed to have a more idiomatic and intuitive experience for JavaScript and TypeScript developers. To learn more, see the [Developer Reference Guide](functions-reference-node.md).
+[!INCLUDE [functions-nodejs-model-pivot-description](../../includes/functions-nodejs-model-pivot-description.md)]
 
-Use the selector at the top to choose the programming model of your choice for completing this quickstart. Note that completion will incur a small cost of a few USD cents or less in your Azure account.
+Note that completion will incur a small cost of a few USD cents or less in your Azure account.
 
 There's also a [CLI-based version](create-first-function-cli-node.md) of this article.
 
diff --git a/articles/azure-functions/create-first-function-vs-code-typescript.md b/articles/azure-functions/create-first-function-vs-code-typescript.md
@@ -12,10 +12,9 @@ zone_pivot_groups: functions-nodejs-model
 
 In this article, you use Visual Studio Code to create a TypeScript function that responds to HTTP requests. After testing the code locally, you deploy it to the serverless environment of Azure Functions.
 
->[!NOTE]
->The v4 programming model for authoring Functions in Node.js is currently in Preview. Compared to the current v3 model, the v4 model is designed to have a more idiomatic and intuitive experience for JavaScript and TypeScript developers. To learn more, see the [Developer Reference Guide](functions-reference-node.md).
+[!INCLUDE [functions-nodejs-model-pivot-description](../../includes/functions-nodejs-model-pivot-description.md)]
 
-Use the selector at the top to choose the programming model of your choice for completing this quickstart. Note that completion will incur a small cost of a few USD cents or less in your Azure account.
+Note that completion will incur a small cost of a few USD cents or less in your Azure account.
 
 There's also a [CLI-based version](create-first-function-cli-typescript.md) of this article.
 
diff --git a/articles/azure-functions/durable/durable-functions-cloud-backup.md b/articles/azure-functions/durable/durable-functions-cloud-backup.md
@@ -10,10 +10,7 @@ ms.author: azfuncdf
 
 *Fan-out/fan-in* refers to the pattern of executing multiple functions concurrently and then performing some aggregation on the results. This article explains a sample that uses [Durable Functions](durable-functions-overview.md) to implement a fan-in/fan-out scenario. The sample is a durable function that backs up all or some of an app's site content into Azure Storage.
 
-> [!NOTE]
-> The new programming model for authoring Functions in Node.js (V4) is currently in preview. Compared to the current model, the new experience is designed to be more idiomatic and intuitive for JavaScript and TypeScript developers. To learn more, see the Azure Functions Node.js [developer guide](../functions-reference-node.md?pivots=nodejs-model-v4).
->
-> In the following code snippets, JavaScript (PM4) denotes programming model V4, the new experience.
+[!INCLUDE [functions-nodejs-durable-model-description](../../../includes/functions-nodejs-durable-model-description.md)]
 
 [!INCLUDE [durable-functions-prerequisites](../../../includes/durable-functions-prerequisites.md)]
 
diff --git a/articles/azure-functions/durable/durable-functions-error-handling.md b/articles/azure-functions/durable/durable-functions-error-handling.md
@@ -11,10 +11,7 @@ ms.devlang: csharp, javascript, powershell, python, java
 
 Durable Function orchestrations are implemented in code and can use the programming language's built-in error-handling features. There really aren't any new concepts you need to learn to add error handling and compensation into your orchestrations. However, there are a few behaviors that you should be aware of.
 
-> [!NOTE]
-> The new programming model for authoring Functions in Node.js (V4) is currently in preview. Compared to the current model, the new experience is designed to be more idiomatic and intuitive for JavaScript and TypeScript developers. To learn more, see the Azure Functions Node.js [developer guide](../functions-reference-node.md?pivots=nodejs-model-v4).
->
-> In the following code snippets, JavaScript (PM4) denotes programming model V4, the new experience.
+[!INCLUDE [functions-nodejs-durable-model-description](../../../includes/functions-nodejs-durable-model-description.md)]
 
 ## Errors in activity functions
 
diff --git a/articles/azure-functions/durable/durable-functions-orchestrations.md b/articles/azure-functions/durable/durable-functions-orchestrations.md
@@ -54,10 +54,7 @@ When an orchestration function is given more work to do (for example, a response
 
 The event-sourcing behavior of the Durable Task Framework is closely coupled with the orchestrator function code you write. Suppose you have an activity-chaining orchestrator function, like the following orchestrator function:
 
-> [!NOTE]
-> The new programming model for authoring Functions in Node.js (V4) is currently in preview. Compared to the current model, the new experience is designed to be more idiomatic and intuitive for JavaScript and TypeScript developers. To learn more, see the Azure Functions Node.js [developer guide](../functions-reference-node.md?pivots=nodejs-model-v4).
->
-> In the following code snippets, JavaScript (PM4) denotes programming model V4, the new experience.
+[!INCLUDE [functions-nodejs-durable-model-description](../../../includes/functions-nodejs-durable-model-description.md)]
 
 # [C# (InProc)](#tab/csharp-inproc)
 
diff --git a/articles/azure-functions/durable/durable-functions-overview.md b/articles/azure-functions/durable/durable-functions-overview.md
@@ -29,7 +29,7 @@ Durable Functions is designed to work with all Azure Functions programming langu
 | Java | Functions 4.0+ | Java 8+ | 4.x bundles |
 
 > [!NOTE]
-> The new programming models for authoring Functions in Python (V2) and Node.js (V4) are currently in preview. Compared to the current models, the new experiences are designed to be more idiomatic and intuitive for Python and JavaScript/TypeScript developers. To learn more, see Azure Functions [Python developer guide](../functions-reference-python.md?pivots=python-mode-decorators) and [Node.js developer guide](../functions-reference-node.md?pivots=nodejs-model-v4).
+> The new programming models for authoring Functions in Python (V2) and Node.js (V4) are currently in preview. Compared to the current models, the new experiences are designed to be more flexible and intuitive for Python and JavaScript/TypeScript developers. Learn more about the differences between the models in the [Python developer guide](../functions-reference-python.md?pivots=python-mode-decorators) and [Node.js upgrade guide](../functions-node-upgrade-v4.md).
 >
 > In the following code snippets, Python (PM2) denotes programming model V2, and JavaScript (PM4) denotes programming model V4, the new experiences.
 
diff --git a/articles/azure-functions/durable/durable-functions-phone-verification.md b/articles/azure-functions/durable/durable-functions-phone-verification.md
@@ -13,10 +13,7 @@ This sample demonstrates how to build a [Durable Functions](durable-functions-ov
 
 This sample implements an SMS-based phone verification system. These types of flows are often used when verifying a customer's phone number or for multi-factor authentication (MFA). It is a powerful example because the entire implementation is done using a couple small functions. No external data store, such as a database, is required.
 
-> [!NOTE]
-> The new programming model for authoring Functions in Node.js (V4) is currently in preview. Compared to the current model, the new experience is designed to be more idiomatic and intuitive for JavaScript and TypeScript developers. To learn more, see the Azure Functions Node.js [developer guide](../functions-reference-node.md?pivots=nodejs-model-v4).
->
-> In the following code snippets, JavaScript (PM4) denotes programming model V4, the new experience.
+[!INCLUDE [functions-nodejs-durable-model-description](../../../includes/functions-nodejs-durable-model-description.md)]
 
 [!INCLUDE [durable-functions-prerequisites](../../../includes/durable-functions-prerequisites.md)]
 
diff --git a/articles/azure-functions/durable/durable-functions-sequence.md b/articles/azure-functions/durable/durable-functions-sequence.md
@@ -14,10 +14,7 @@ Function chaining refers to the pattern of executing a sequence of functions in
 
 [!INCLUDE [durable-functions-prerequisites](../../../includes/durable-functions-prerequisites.md)]
 
-> [!NOTE]
-> The new programming model for authoring Functions in Node.js (V4) is currently in preview. Compared to the current model, the new experience is designed to be more idiomatic and intuitive for JavaScript and TypeScript developers. To learn more, see the Azure Functions Node.js [developer guide](../functions-reference-node.md?pivots=nodejs-model-v4).
->
-> In the following code snippets, JavaScript (PM4) denotes programming model V4, the new experience.
+[!INCLUDE [functions-nodejs-durable-model-description](../../../includes/functions-nodejs-durable-model-description.md)]
 
 ## The functions
 
diff --git a/articles/azure-functions/durable/durable-functions-sub-orchestrations.md b/articles/azure-functions/durable/durable-functions-sub-orchestrations.md
@@ -17,10 +17,7 @@ Sub-orchestrator functions behave just like activity functions from the caller's
 > [!NOTE]
 > Sub-orchestrations are not yet supported in PowerShell.
 
-> [!NOTE]
-> The new programming model for authoring Functions in Node.js (V4) is currently in preview. Compared to the current model, the new experience is designed to be more idiomatic and intuitive for JavaScript and TypeScript developers. To learn more, see the Azure Functions Node.js [developer guide](../functions-reference-node.md?pivots=nodejs-model-v4).
->
-> In the following code snippets, JavaScript (PM4) denotes programming model V4, the new experience.
+[!INCLUDE [functions-nodejs-durable-model-description](../../../includes/functions-nodejs-durable-model-description.md)]
 
 ## Example
 
diff --git a/articles/azure-functions/durable/quickstart-js-vscode.md b/articles/azure-functions/durable/quickstart-js-vscode.md
@@ -16,11 +16,7 @@ zone_pivot_groups: functions-nodejs-model
 
 In this article, you learn how to use the Visual Studio Code Azure Functions extension to locally create and test a "hello world" durable function.  This function will orchestrate and chain together calls to other functions. You then publish the function code to Azure.
 
-
->[!NOTE]
->The v4 programming model for authoring Functions in Node.js is currently in preview. Compared to the current v3 model, the v4 model is designed to have a more idiomatic and intuitive experience for JavaScript and TypeScript developers. To learn more, see the [Developer Reference Guide](../functions-reference-node.md).
->
->Use the selector at the top to choose the programming model of your choice for completing this quickstart.
+[!INCLUDE [functions-nodejs-model-pivot-description](../../../includes/functions-nodejs-model-pivot-description.md)]
 
 ![Screenshot of an Edge window. The window shows the output of invoking a simple durable function in Azure.](./media/quickstart-js-vscode/functions-vs-code-complete.png)
 
diff --git a/articles/azure-functions/durable/quickstart-ts-vscode.md b/articles/azure-functions/durable/quickstart-ts-vscode.md
@@ -16,11 +16,7 @@ zone_pivot_groups: functions-nodejs-model
 
 In this article, you learn how to use the Visual Studio Code Azure Functions extension to locally create and test a "hello world" durable function.  This function will orchestrate and chain together calls to other functions. You then publish the function code to Azure.
 
-
->[!NOTE]
->The v4 programming model for authoring Functions in Node.js is currently in Preview. Compared to the current v3 model, the v4 model is designed to have a more idiomatic and intuitive experience for JavaScript and TypeScript developers. To learn more, see the [Developer Reference Guide](../functions-reference-node.md).
->
->Use the selector at the top to choose the programming model of your choice for completing this quickstart.
+[!INCLUDE [functions-nodejs-model-pivot-description](../../../includes/functions-nodejs-model-pivot-description.md)]
 
 ![Screenshot of an Edge window. The window shows the output of invoking a simple durable function in Azure.](./media/quickstart-js-vscode/functions-vs-code-complete.png)
 
diff --git a/includes/functions-nodejs-durable-model-description.md b/includes/functions-nodejs-durable-model-description.md
@@ -0,0 +1,15 @@
+---
+title: include file
+description: include file
+author: ejizba
+ms.service: azure-functions
+ms.topic: include
+ms.date: 03/24/2023
+ms.author: erijiz
+ms.custom: include file
+---
+
+> [!NOTE]
+> Version 4 of the Node.js programming model for Azure Functions is in preview. The new v4 model is designed to have a more flexible and intuitive experience for JavaScript and TypeScript developers. Learn more about the differences between v3 and v4 in the [upgrade guide](../articles/azure-functions/functions-node-upgrade-v4.md).
+>
+> In the following code snippets, JavaScript (PM4) denotes programming model V4, the new experience.
diff --git a/includes/functions-nodejs-model-pivot-description.md b/includes/functions-nodejs-model-pivot-description.md
@@ -0,0 +1,13 @@
+---
+title: include file
+description: include file
+author: ejizba
+ms.service: azure-functions
+ms.topic: include
+ms.date: 03/24/2023
+ms.author: erijiz
+ms.custom: include file
+---
+
+> [!IMPORTANT]
+> The content of this article changes based on your choice of the Node.js programming model in the selector at the top of the page. The v4 model is currently in preview and is designed to have a more flexible and intuitive experience for JavaScript and TypeScript developers. Learn more about the differences between v3 and v4 in the [upgrade guide](../articles/azure-functions/functions-node-upgrade-v4.md).

Original file line number	Diff line number	Diff line change
`@@ -29,7 +29,7 @@ Durable Functions is designed to work with all Azure Functions programming langu`
`29`	`29`	`\| Java \| Functions 4.0+ \| Java 8+ \| 4.x bundles \|`
`30`	`30`
`31`	`31`	`> [!NOTE]`
`32`		`-> The new programming models for authoring Functions in Python (V2) and Node.js (V4) are currently in preview. Compared to the current models, the new experiences are designed to be more idiomatic and intuitive for Python and JavaScript/TypeScript developers. To learn more, see Azure Functions [Python developer guide](../functions-reference-python.md?pivots=python-mode-decorators) and [Node.js developer guide](../functions-reference-node.md?pivots=nodejs-model-v4).`
	`32`	`+> The new programming models for authoring Functions in Python (V2) and Node.js (V4) are currently in preview. Compared to the current models, the new experiences are designed to be more flexible and intuitive for Python and JavaScript/TypeScript developers. Learn more about the differences between the models in the [Python developer guide](../functions-reference-python.md?pivots=python-mode-decorators) and [Node.js upgrade guide](../functions-node-upgrade-v4.md).`
`33`	`33`	`>`
`34`	`34`	`> In the following code snippets, Python (PM2) denotes programming model V2, and JavaScript (PM4) denotes programming model V4, the new experiences.`
`35`	`35`