added links

Author: tfitzmac

articles/azure-resource-manager/resource-group-authoring-templates.md

@@ -4,7 +4,7 @@ description: Describes the structure and properties of Azure Resource Manager te
 author: tfitzmac
 ms.service: azure-resource-manager
 ms.topic: conceptual
-ms.date: 08/29/2019
+ms.date: 09/13/2019
 ms.author: tomfitz
 ---
 
@@ -79,6 +79,8 @@ The available properties for a parameter are:
 | maxLength |No |The maximum length for string, secure string, and array type parameters, this value is inclusive. |
 | description |No |Description of the parameter that is displayed to users through the portal. For more information, see [Comments in templates](#comments). |
 
+For examples of how to use parameters, see [Parameters in Azure Resource Manager templates](template-parameters.md).
+
 ## Variables
 
 In the variables section, you construct values that can be used throughout your template. You don't need to define variables, but they often simplify your template by reducing complex expressions.
@@ -112,6 +114,8 @@ The following example shows the available options for defining a variable:
 
 For information about using `copy` to create several values for a variable, see [Variable iteration](resource-group-create-multiple.md#variable-iteration).
 
+For examples of how to use variables, see [Variables in Azure Resource Manager template](template-variables.md).
+
 ## Functions
 
 Within your template, you can create your own functions. These functions are available for use in your template. Typically, you define complicated expression that you don't want to repeat throughout your template. You create the user-defined functions from expressions and [functions](resource-group-template-functions.md) that are supported in templates.
@@ -155,6 +159,8 @@ When defining a user function, there are some restrictions:
 | output-type |Yes |Type of the output value. Output values support the same types as function input parameters. |
 | output-value |Yes |Template language expression that is evaluated and returned from the function. |
 
+For examples of how to use custom functions, see [User-defined functions in Azure Resource Manager template](template-user-defined-functions.md).
+
 ## Resources
 
 In the resources section, you define the resources that are deployed or updated.
@@ -255,6 +261,8 @@ The following example shows the structure of an output definition:
 | type |Yes |Type of the output value. Output values support the same types as template input parameters. If you specify **securestring** for the output type, the value isn't displayed in the deployment history and can't be retrieved from another template. To use a secret value in more than one template, store the secret in a Key Vault and reference the secret in the parameter file. For more information, see [Use Azure Key Vault to pass secure parameter value during deployment](resource-manager-keyvault-parameter.md). |
 | value |Yes |Template language expression that is evaluated and returned as output value. |
 
+For examples of how to use outputs, see [Outputs in Azure Resource Manager template](template-outputs.md).
+
 <a id="comments" />
 
 ## Comments and metadata

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

@@ -4,7 +4,7 @@ description: Describes the functions to use in an Azure Resource Manager templat
 author: tfitzmac
 ms.service: azure-resource-manager
 ms.topic: conceptual
-ms.date: 01/03/2019
+ms.date: 09/13/2019
 ms.author: tomfitz
 
 ---
@@ -20,8 +20,6 @@ To get values from resources, resource groups, or subscriptions, see [Resource f
 
 <a id="deployment" />
 
-[!INCLUDE [updated-for-az](../../includes/updated-for-az.md)]
-
 ## deployment
 `deployment()`
 
@@ -131,18 +129,6 @@ The preceding example returns the following object:
 }
 ```
 
-To deploy this example template with Azure CLI, use:
-
-```azurecli-interactive
-az group deployment create -g functionexamplegroup --template-uri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/functions/deployment.json
-```
-
-To deploy this example template with PowerShell, use:
-
-```powershell
-New-AzResourceGroupDeployment -ResourceGroupName functionexamplegroup -TemplateUri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/functions/deployment.json
-```
-
 For a subscription-level template that uses the deployment function, see [subscription deployment function](https://github.com/Azure/azure-docs-json-samples/blob/master/azure-resource-manager/functions/deploymentsubscription.json). It's deployed with either `az deployment create` or `New-AzDeployment` commands.
 
 <a id="parameters" />
@@ -249,17 +235,7 @@ The output from the preceding example with the default values is:
 | arrayOutput | Array | [1, 2, 3] |
 | crossOutput | String | option 1 |
 
-To deploy this example template with Azure CLI, use:
-
-```azurecli-interactive
-az group deployment create -g functionexamplegroup --template-uri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/functions/parameters.json
-```
-
-To deploy this example template with PowerShell, use:
-
-```powershell
-New-AzResourceGroupDeployment -ResourceGroupName functionexamplegroup -TemplateUri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/functions/parameters.json
-```
+For more information about using parameters, see [Parameters in Azure Resource Manager template](template-parameters.md).
 
 <a id="variables" />
 
@@ -351,17 +327,7 @@ The output from the preceding example with the default values is:
 | exampleOutput3 | String | myVariable |
 | exampleOutput4 |  Object | {"property1": "value1", "property2": "value2"} |
 
-To deploy this example template with Azure CLI, use:
-
-```azurecli-interactive
-az group deployment create -g functionexamplegroup --template-uri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/functions/variables.json
-```
-
-To deploy this example template with PowerShell, use:
-
-```powershell
-New-AzResourceGroupDeployment -ResourceGroupName functionexamplegroup -TemplateUri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/functions/variables.json
-```
+For more information about using variables, see [Variables in Azure Resource Manager template](template-variables.md).
 
 ## Next steps
 * For a description of the sections in an Azure Resource Manager template, see [Authoring Azure Resource Manager templates](resource-group-authoring-templates.md).

articles/azure-resource-manager/resource-manager-parameter-files.md

@@ -199,6 +199,6 @@ If your template includes a parameter with the same name as one of the parameter
 
 ## Next steps
 
-- To understand how to define parameters in your template, see [Understand the structure and syntax of Azure Resource Manager templates](resource-group-authoring-templates.md).
+- To understand how to define parameters in your template, see [Parameters in Azure Resource Manager templates](template-parameters.md).
 - For more information about using values from a key vault, see [Use Azure Key Vault to pass secure parameter value during deployment](resource-manager-keyvault-parameter.md).
-
+- For more information about parameters, see [Parameters in Azure Resource Manager templates](template-parameters.md).

articles/azure-resource-manager/template-best-practices.md

@@ -1,15 +1,10 @@
 ---
 title: Best practices for Azure Resource Manager templates
 description: Describes recommended approaches for authoring Azure Resource Manager templates. Offers suggestions to avoid common problems when using templates. 
-services: azure-resource-manager
-documentationcenter: na
 author: tfitzmac
 ms.service: azure-resource-manager
-ms.devlang: na
 ms.topic: conceptual
-ms.tgt_pltfrm: na
-ms.workload: na
-ms.date: 08/16/2019
+ms.date: 09/12/2019
 ms.author: tomfitz
 ---
 # Azure Resource Manager template best practices
@@ -41,7 +36,8 @@ When you deploy resources to a resource group, the resource group stores metadat
 If the resource group's region is temporarily unavailable, you can't update resources in the resource group because the metadata is unavailable. The resources in other regions will still function as expected, but you can't update them. To minimize risk, locate your resource group and resources in the same region.
 
 ## Parameters
-The information in this section can be helpful when you work with [parameters](resource-group-authoring-templates.md#parameters).
+
+The information in this section can be helpful when you work with [parameters](template-parameters.md).
 
 ### General recommendations for parameters
 
@@ -143,7 +139,7 @@ The information in this section can be helpful when you work with [parameters](r
 
 ## Variables
 
-The following information can be helpful when you work with [variables](resource-group-authoring-templates.md#variables):
+The following information can be helpful when you work with [variables](template-variables.md):
 
 * Use camel case for variable names.
 
@@ -280,7 +276,7 @@ The following information can be helpful when you work with [resources](resource
 
 ## Outputs
 
-If you use a template to create public IP addresses, include an [outputs section](resource-group-authoring-templates.md#outputs) that returns details of the IP address and the fully qualified domain name (FQDN). You can use output values to easily retrieve details about public IP addresses and FQDNs after deployment.
+If you use a template to create public IP addresses, include an [outputs section](template-outputs.md) that returns details of the IP address and the fully qualified domain name (FQDN). You can use output values to easily retrieve details about public IP addresses and FQDNs after deployment.
 
 ```json
 "outputs": {