Merge pull request #188396 from davidsmatlak/ds-add-bicep-tips

Adds links to Bicep docs

Author: LJSpiller

articles/azure-resource-manager/templates/quickstart-create-templates-use-visual-studio-code.md

@@ -17,6 +17,9 @@ To complete this quickstart, you need [Visual Studio Code](https://code.visualst
 
 If you don't have an Azure subscription, [create a free account](https://azure.microsoft.com/free/) before you begin.
 
+> [!TIP]
+> We recommend [Bicep](../bicep/overview.md) because it offers the same capabilities as ARM templates and the syntax is easier to use. To learn more, see [Quickstart: Create Bicep files with Visual Studio Code](../bicep/quickstart-create-bicep-use-visual-studio-code.md).
+
 ## Create an ARM template
 
 Create and open with Visual Studio Code a new file named *azuredeploy.json*. Enter `arm` into the code editor, which initiates Azure Resource Manager snippets for scaffolding out an ARM template.
@@ -29,7 +32,7 @@ This snippet creates the basic building blocks for an ARM template.
 
 ![Image showing a fully scaffolded ARM template](./media/quickstart-create-templates-use-visual-studio-code/2.png)
 
-Notice that the Visual Studio Code language mode has changed from *JSON* to *Azure Resource Manager Template*. The extension includes a language server specific to ARM templates which provides ARM template-specific validation, completion, and other language services.
+Notice that the Visual Studio Code language mode has changed from *JSON* to *Azure Resource Manager Template*. The extension includes a language server specific to ARM templates that provides ARM template-specific validation, completion, and other language services.
 
 ![Image showing Azure Resource Manager as the Visual Studio Code language mode](./media/quickstart-create-templates-use-visual-studio-code/3.png)
 
@@ -53,7 +56,7 @@ The **tab** key can be used to tab through configurable properties on the storag
 
 One of the most powerful capabilities of the extension is its integration with Azure schemas. Azure schemas provide the extension with validation and resource-aware completion capabilities. Let's modify the storage account to see validation and completion in action.
 
-First, update the storage account kind to an invalid value such as `megaStorage`. Notice that this action produces a warning indicating that `megaStorage` is not a valid value.
+First, update the storage account kind to an invalid value such as `megaStorage`. Notice that this action produces a warning indicating that `megaStorage` isn't a valid value.
 
 ![Image showing an invalid storage configuration](./media/quickstart-create-templates-use-visual-studio-code/7.png)
 
@@ -105,7 +108,7 @@ Now that the parameter file has been mapped to the template, the extension valid
 
 ![Image showing an invalidated template due to parameter file issue](./media/quickstart-create-templates-use-visual-studio-code/17.png)
 
-Navigate back to the ARM template and notice that an error has been raised indicating that the value does not meet the parameter criteria.
+Navigate back to the ARM template and notice that an error has been raised indicating that the value doesn't meet the parameter criteria.
 
 ![Image showing a valid ARM template](./media/quickstart-create-templates-use-visual-studio-code/18.png)
 

articles/azure-resource-manager/templates/template-functions-array.md

@@ -2,7 +2,7 @@
 title: Template functions - arrays
 description: Describes the functions to use in an Azure Resource Manager template (ARM template) for working with arrays.
 ms.topic: conceptual
-ms.date: 09/08/2021
+ms.date: 02/11/2022
 ---
 
 # Array functions for ARM templates
@@ -27,6 +27,9 @@ Resource Manager provides several functions for working with arrays in your Azur
 
 To get an array of string values delimited by a value, see [split](template-functions-string.md#split).
 
+> [!TIP]
+> We recommend [Bicep](../bicep/overview.md) because it offers the same capabilities as ARM templates and the syntax is easier to use. To learn more, see [array](../bicep/bicep-functions-array.md) functions.
+
 ## array
 
 `array(convertToArray)`

articles/azure-resource-manager/templates/template-functions-comparison.md

@@ -2,7 +2,7 @@
 title: Template functions - comparison
 description: Describes the functions to use in an Azure Resource Manager template (ARM template) to compare values.
 ms.topic: conceptual
-ms.date: 09/08/2021
+ms.date: 02/11/2022
 ---
 
 # Comparison functions for ARM templates
@@ -16,6 +16,9 @@ Resource Manager provides several functions for making comparisons in your Azure
 * [less](#less)
 * [lessOrEquals](#lessorequals)
 
+> [!TIP]
+> We recommend [Bicep](../bicep/overview.md) because it offers the same capabilities as ARM templates and the syntax is easier to use. To learn more, see the [coalesce](../bicep/operators-logical.md) logical operator and [comparison](../bicep/operators-comparison.md) operators.
+
 ## coalesce
 
 `coalesce(arg1, arg2, arg3, ...)`

articles/azure-resource-manager/templates/template-functions-date.md

@@ -2,7 +2,7 @@
 title: Template functions - date
 description: Describes the functions to use in an Azure Resource Manager template (ARM template) to work with dates.
 ms.topic: conceptual
-ms.date: 09/09/2021
+ms.date: 02/11/2022
 ---
 
 # Date functions for ARM templates
@@ -12,6 +12,9 @@ Resource Manager provides the following functions for working with dates in your
 * [dateTimeAdd](#datetimeadd)
 * [utcNow](#utcnow)
 
+> [!TIP]
+> We recommend [Bicep](../bicep/overview.md) because it offers the same capabilities as ARM templates and the syntax is easier to use. To learn more, see [date](../bicep/bicep-functions-date.md) functions.
+
 ## dateTimeAdd
 
 `dateTimeAdd(base, duration, [format])`
@@ -64,9 +67,9 @@ Returns the current (UTC) datetime value in the specified format. If no format i
 
 You can only use this function within an expression for the default value of a parameter. Using this function anywhere else in a template returns an error. The function isn't allowed in other parts of the template because it returns a different value each time it's called. Deploying the same template with the same parameters wouldn't reliably produce the same results.
 
-If you use the [option to rollback on error](rollback-on-error.md) to an earlier successful deployment, and the earlier deployment includes a parameter that uses utcNow, the parameter isn't reevaluated. Instead, the parameter value from the earlier deployment is automatically reused in the rollback deployment.
+If you use the [option to rollback on error](rollback-on-error.md) to an earlier successful deployment, and the earlier deployment includes a parameter that uses `utcNow`, the parameter isn't reevaluated. Instead, the parameter value from the earlier deployment is automatically reused in the rollback deployment.
 
-Be careful redeploying a template that relies on the utcNow function for a default value. When you redeploy and don't provide a value for the parameter, the function is reevaluated. If you want to update an existing resource rather than create a new one, pass in the parameter value from the earlier deployment.
+Be careful redeploying a template that relies on the `utcNow` function for a default value. When you redeploy and don't provide a value for the parameter, the function is reevaluated. If you want to update an existing resource rather than create a new one, pass in the parameter value from the earlier deployment.
 
 ### Return value
 

articles/azure-resource-manager/templates/template-functions-deployment.md

@@ -2,7 +2,7 @@
 title: Template functions - deployment
 description: Describes the functions to use in an Azure Resource Manager template (ARM template) to retrieve deployment information.
 ms.topic: conceptual
-ms.date: 09/09/2021
+ms.date: 02/11/2022
 ---
 
 # Deployment functions for ARM templates
@@ -16,6 +16,9 @@ Resource Manager provides the following functions for getting values related to
 
 To get values from resources, resource groups, or subscriptions, see [Resource functions](template-functions-resource.md).
 
+> [!TIP]
+> We recommend [Bicep](../bicep/overview.md) because it offers the same capabilities as ARM templates and the syntax is easier to use. To learn more, see [deployment](../bicep/bicep-functions-deployment.md) functions.
+
 ## deployment
 
 `deployment()`

articles/azure-resource-manager/templates/template-functions-logical.md

@@ -2,7 +2,7 @@
 title: Template functions - logical
 description: Describes the functions to use in an Azure Resource Manager template (ARM template) to determine logical values.
 ms.topic: conceptual
-ms.date: 09/09/2021
+ms.date: 02/11/2022
 ---
 
 # Logical functions for ARM templates
@@ -17,6 +17,9 @@ Resource Manager provides several functions for making comparisons in your Azure
 * [or](#or)
 * [true](#true)
 
+> [!TIP]
+> We recommend [Bicep](../bicep/overview.md) because it offers the same capabilities as ARM templates and the syntax is easier to use. To learn more, see the [bool](../bicep/bicep-functions-logical.md) logical function and [logical](../bicep/operators-logical.md) operators.
+
 ## and
 
 `and(arg1, arg2, ...)`

articles/azure-resource-manager/templates/template-functions-numeric.md

@@ -2,7 +2,7 @@
 title: Template functions - numeric
 description: Describes the functions to use in an Azure Resource Manager template (ARM template) to work with numbers.
 ms.topic: conceptual
-ms.date: 09/09/2021
+ms.date: 02/11/2022
 ---
 
 # Numeric functions for ARM templates
@@ -20,6 +20,9 @@ Resource Manager provides the following functions for working with integers in y
 * [mul](#mul)
 * [sub](#sub)
 
+> [!TIP]
+> We recommend [Bicep](../bicep/overview.md) because it offers the same capabilities as ARM templates and the syntax is easier to use. To learn more about using `int`, `min`, and `max` in Bicep, see [numeric](../bicep/bicep-functions-numeric.md) functions. For other numeric values, see [numeric](../bicep/operators-numeric.md) operators.
+
 ## add
 
 `add(operand1, operand2)`

articles/azure-resource-manager/templates/template-functions-object.md

@@ -2,7 +2,7 @@
 title: Template functions - objects
 description: Describes the functions to use in an Azure Resource Manager template (ARM template) for working with objects.
 ms.topic: conceptual
-ms.date: 09/09/2021
+ms.date: 02/11/2022
 ---
 
 # Object functions for ARM templates
@@ -18,6 +18,9 @@ Resource Manager provides several functions for working with objects in your Azu
 * [null](#null)
 * [union](#union)
 
+> [!TIP]
+> We recommend [Bicep](../bicep/overview.md) because it offers the same capabilities as ARM templates and the syntax is easier to use. To learn more, see [object](../bicep/bicep-functions-object.md) functions.
+
 ## contains
 
 `contains(container, itemToFind)`

articles/azure-resource-manager/templates/template-functions-resource.md

@@ -2,7 +2,7 @@
 title: Template functions - resources
 description: Describes the functions to use in an Azure Resource Manager template (ARM template) to retrieve values about resources.
 ms.topic: conceptual
-ms.date: 12/28/2021
+ms.date: 02/11/2022
 ms.custom: devx-track-azurepowershell
 ---
 
@@ -23,6 +23,9 @@ To get values from parameters, variables, or the current deployment, see [Deploy
 
 To get deployment scope values, see [Scope functions](template-functions-scope.md).
 
+> [!TIP]
+> We recommend [Bicep](../bicep/overview.md) because it offers the same capabilities as ARM templates and the syntax is easier to use. To learn more, see [resource](../bicep/bicep-functions-resource.md) functions.
+
 ## extensionResourceId
 
 `extensionResourceId(baseResourceId, resourceType, resourceName1, [resourceName2], ...)`

articles/azure-resource-manager/templates/template-functions-scope.md

@@ -2,7 +2,7 @@
 title: Template functions - scope
 description: Describes the functions to use in an Azure Resource Manager template (ARM template) to retrieve values about deployment scope.
 ms.topic: conceptual
-ms.date: 11/23/2021
+ms.date: 02/11/2022
 ---
 
 # Scope functions for ARM templates
@@ -16,6 +16,9 @@ Resource Manager provides the following functions for getting deployment scope v
 
 To get values from parameters, variables, or the current deployment, see [Deployment value functions](template-functions-deployment.md).
 
+> [!TIP]
+> We recommend [Bicep](../bicep/overview.md) because it offers the same capabilities as ARM templates and the syntax is easier to use. To learn more, see [scope](../bicep/bicep-functions-scope.md) functions.
+
 ## managementGroup
 
 `managementGroup()`