Merge pull request #127548 from DCtheGeek/dmc-bp-freshness202008

American-Dipper · web-flow · commit d430ce4ddd16 · 2020-08-27T19:52:46.000-07:00
Blueprints: Acrolinx and freshness review
diff --git a/articles/governance/blueprints/concepts/deployment-stages.md b/articles/governance/blueprints/concepts/deployment-stages.md
@@ -1,7 +1,7 @@
 ---
 title: Stages of a blueprint deployment
 description: Learn the security and artifact related steps the Azure Blueprints services goes through while creating a blueprint assignment.
-ms.date: 05/06/2020
+ms.date: 08/27/2020
 ms.topic: conceptual
 ---
 # Stages of a blueprint deployment
@@ -95,8 +95,9 @@ subscription.
 
 ## Next steps
 
-- Understand how to use [static and dynamic parameters](parameters.md).
-- Learn to customize the [blueprint sequencing order](sequencing-order.md).
-- Find out how to make use of [blueprint resource locking](resource-locking.md).
+- Understand how to use [static and dynamic parameters](./parameters.md).
+- Learn to customize the [blueprint sequencing order](./sequencing-order.md).
+- Find out how to make use of [blueprint resource locking](./resource-locking.md).
 - Learn how to [update existing assignments](../how-to/update-existing-assignments.md).
-- Resolve issues during the assignment of a blueprint with [general troubleshooting](../troubleshoot/general.md).
+- Resolve issues during the assignment of a blueprint with
+  [general troubleshooting](../troubleshoot/general.md).
diff --git a/articles/governance/blueprints/concepts/lifecycle.md b/articles/governance/blueprints/concepts/lifecycle.md
@@ -1,7 +1,7 @@
 ---
 title: Understand the lifecycle of a blueprint
 description: Learn about the lifecycle that a blueprint definition goes through and details about each stage, including updating and removing blueprint assignments.
-ms.date: 05/06/2020
+ms.date: 08/27/2020
 ms.topic: conceptual
 ---
 # Understand the lifecycle of an Azure Blueprint
@@ -111,15 +111,15 @@ a newer version is being developed.
 
 As versions of blueprints are assigned, it's important to understand where they're assigned and with
 what parameters they've been assigned with. The parameters can either be static or dynamic. To learn
-more, see [static and dynamic parameters](parameters.md).
+more, see [static and dynamic parameters](./parameters.md).
 
 ### Updating assignments
 
 When a blueprint is assigned, the assignment can be updated. There are several reasons for updating
 an existing assignment, including:
 
-- Add or remove [resource locking](resource-locking.md)
-- Change the value of [dynamic parameters](parameters.md#dynamic-parameters)
+- Add or remove [resource locking](./resource-locking.md)
+- Change the value of [dynamic parameters](./parameters.md#dynamic-parameters)
 - Upgrade the assignment to a newer **Published** version of the blueprint
 
 To learn how, see [update existing assignments](../how-to/update-existing-assignments.md).
@@ -129,7 +129,7 @@ To learn how, see [update existing assignments](../how-to/update-existing-assign
 If the blueprint is no longer needed, it can be unassigned from the management group or
 subscription. During blueprint unassignment, the following occurs:
 
-- Removal of [blueprint resource locking](resource-locking.md)
+- Removal of [blueprint resource locking](./resource-locking.md)
 - Deletion of the blueprint assignment object
 - (Conditional) If a **system-assigned managed identity** was used, it's also deleted
 
@@ -139,8 +139,9 @@ subscription. During blueprint unassignment, the following occurs:
 
 ## Next steps
 
-- Understand how to use [static and dynamic parameters](parameters.md).
-- Learn to customize the [blueprint sequencing order](sequencing-order.md).
-- Find out how to make use of [blueprint resource locking](resource-locking.md).
+- Understand how to use [static and dynamic parameters](./parameters.md).
+- Learn to customize the [blueprint sequencing order](./sequencing-order.md).
+- Find out how to make use of [blueprint resource locking](./resource-locking.md).
 - Learn how to [update existing assignments](../how-to/update-existing-assignments.md).
-- Resolve issues during the assignment of a blueprint with [general troubleshooting](../troubleshoot/general.md).
+- Resolve issues during the assignment of a blueprint with
+  [general troubleshooting](../troubleshoot/general.md).
diff --git a/articles/governance/blueprints/concepts/parameters.md b/articles/governance/blueprints/concepts/parameters.md
@@ -1,7 +1,7 @@
 ---
 title: Use parameters to creating dynamic blueprints
 description: Learn about static and dynamic parameters and how to use them to create secure and dynamic blueprints.
-ms.date: 04/15/2020
+ms.date: 08/27/2020
 ms.topic: conceptual
 ---
 # Creating dynamic blueprints through parameters
@@ -85,13 +85,13 @@ you define as required vs what can be changed during assignment.
 
 1. Select **Blueprint definitions** from the page on the left.
 
-1. Click on an existing blueprint and then click **Edit blueprint** OR click **+ Create blueprint**
+1. Select an existing blueprint and then select **Edit blueprint** OR select **+ Create blueprint**
    and fill out the information on the **Basics** tab.
 
-1. Click **Next: Artifacts** OR click on the **Artifacts** tab.
+1. Select **Next: Artifacts** OR select the **Artifacts** tab.
 
 1. Artifacts added to the blueprint that have parameter options display **X of Y parameters
-   populated** in the **Parameters** column. Click on the artifact row to edit the artifact
+   populated** in the **Parameters** column. Select the artifact row to edit the artifact
    parameters.
 
    :::image type="content" source="../media/parameters/parameter-column.png" alt-text="Blueprint parameters on a blueprint definition" border="false":::
@@ -219,8 +219,8 @@ different name for every assignment of the blueprint. For a list of blueprint fu
 
 1. Select **Blueprint definitions** from the page on the left.
 
-1. Right-click on the blueprint that you want to assign. Select **Assign blueprint** OR click on the
-   blueprint you want to assign, then click the **Assign blueprint** button.
+1. Right-click on the blueprint that you want to assign. Select **Assign blueprint** OR select the
+   blueprint you want to assign, then use the **Assign blueprint** button.
 
 1. On the **Assign blueprint** page, find the **Artifact parameters** section. Each artifact with at
    least one **dynamic parameter** displays the artifact and the configuration options. Provide
@@ -290,8 +290,9 @@ a dynamic parameter that isn't provided during assignment, the assignment will f
 ## Next steps
 
 - See the list of [blueprint functions](../reference/blueprint-functions.md).
-- Learn about the [blueprint lifecycle](lifecycle.md).
-- Learn to customize the [blueprint sequencing order](sequencing-order.md).
-- Find out how to make use of [blueprint resource locking](resource-locking.md).
+- Learn about the [blueprint lifecycle](./lifecycle.md).
+- Learn to customize the [blueprint sequencing order](./sequencing-order.md).
+- Find out how to make use of [blueprint resource locking](./resource-locking.md).
 - Learn how to [update existing assignments](../how-to/update-existing-assignments.md).
-- Resolve issues during the assignment of a blueprint with [general troubleshooting](../troubleshoot/general.md).
+- Resolve issues during the assignment of a blueprint with
+  [general troubleshooting](../troubleshoot/general.md).
diff --git a/articles/governance/blueprints/concepts/resource-locking.md b/articles/governance/blueprints/concepts/resource-locking.md
@@ -1,7 +1,7 @@
 ---
 title: Understand resource locking
 description: Learn about the locking options in Azure Blueprints to protect resources when assigning a blueprint.
-ms.date: 03/25/2020
+ms.date: 08/27/2020
 ms.topic: conceptual
 ---
 # Understand resource locking in Azure Blueprints
@@ -31,7 +31,7 @@ Locked** state. The following table can be used to determine the state of a reso
 |-|-|-|-|
 |Don't Lock|*|Not Locked|Resources aren't protected by Azure Blueprints. This state is also used for resources added to a **Read Only** or **Do Not Delete** resource group artifact from outside a blueprint assignment.|
 |Read Only|Resource group|Cannot Edit / Delete|The resource group is read only and tags on the resource group can't be modified. **Not Locked** resources can be added, moved, changed, or deleted from this resource group.|
-|Read Only|Non-resource group|Read Only|The resource can't be altered in any way -- no changes and it can't be deleted.|
+|Read Only|Non-resource group|Read Only|The resource can't be altered in any way. No changes and it can't be deleted.|
 |Do Not Delete|*|Cannot Delete|The resources can be altered, but can't be deleted. **Not Locked** resources can be added, moved, changed, or deleted from this resource group.|
 
 ## Overriding locking states
@@ -223,8 +223,9 @@ wildcard matching of RBAC operations.
 ## Next steps
 
 - Follow the [protect new resources](../tutorials/protect-new-resources.md) tutorial.
-- Learn about the [blueprint lifecycle](lifecycle.md).
-- Understand how to use [static and dynamic parameters](parameters.md).
-- Learn to customize the [blueprint sequencing order](sequencing-order.md).
+- Learn about the [blueprint lifecycle](./lifecycle.md).
+- Understand how to use [static and dynamic parameters](./parameters.md).
+- Learn to customize the [blueprint sequencing order](./sequencing-order.md).
 - Learn how to [update existing assignments](../how-to/update-existing-assignments.md).
-- Resolve issues during the assignment of a blueprint with [general troubleshooting](../troubleshoot/general.md).
+- Resolve issues during the assignment of a blueprint with
+  [general troubleshooting](../troubleshoot/general.md).
diff --git a/articles/governance/blueprints/concepts/sequencing-order.md b/articles/governance/blueprints/concepts/sequencing-order.md
@@ -1,7 +1,7 @@
 ---
 title: Understand the deployment sequence order
 description: Learn about the default order that blueprint artifacts are deployed in during a blueprint assignment and how to customize the deployment order.
-ms.date: 05/06/2020
+ms.date: 08/27/2020
 ms.topic: conceptual
 ---
 # Understand the deployment sequence in Azure Blueprints
@@ -162,8 +162,9 @@ order and no changes would be made.
 
 ## Next steps
 
-- Learn about the [blueprint lifecycle](lifecycle.md).
-- Understand how to use [static and dynamic parameters](parameters.md).
-- Find out how to make use of [blueprint resource locking](resource-locking.md).
+- Learn about the [blueprint lifecycle](./lifecycle.md).
+- Understand how to use [static and dynamic parameters](./parameters.md).
+- Find out how to make use of [blueprint resource locking](./resource-locking.md).
 - Learn how to [update existing assignments](../how-to/update-existing-assignments.md).
-- Resolve issues during the assignment of a blueprint with [general troubleshooting](../troubleshoot/general.md).
+- Resolve issues during the assignment of a blueprint with
+  [general troubleshooting](../troubleshoot/general.md).
diff --git a/articles/governance/blueprints/create-blueprint-portal.md b/articles/governance/blueprints/create-blueprint-portal.md
@@ -1,7 +1,7 @@
 ---
 title: "Quickstart: Create a blueprint in the portal"
 description: In this quickstart, you use Azure Blueprints to create, define, and deploy artifacts through the Azure portal.
-ms.date: 03/25/2020
+ms.date: 08/27/2020
 ms.topic: quickstart
 ---
 # Quickstart: Define and assign a blueprint in the portal
@@ -75,8 +75,8 @@ Manager template and role assignment on the new resource group.
 
    1. Change **Type** to **Built-in**. In **Search**, enter **tag**.
 
-   1. Click out of **Search** for the filtering to occur. Select **Append tag and its default value
-      to resource groups**.
+   1. Change focus out of **Search** for the filtering to occur. Select **Append tag and its default
+      value to resource groups**.
 
    1. Select **Add** to add this artifact to the blueprint.
 
@@ -254,8 +254,8 @@ is saved to a subscription, it can only be assigned to that subscription.
    subscriptions that you want to deploy this blueprint to.
 
    If there are supported Enterprise offerings available from
-   [Azure Billing](../../cost-management-billing/index.yml), a **Create new** link is activated under the
-   **Subscription** box. Follow these steps:
+   [Azure Billing](../../cost-management-billing/index.yml), a **Create new** link is activated
+   under the **Subscription** box. Follow these steps:
 
    1. Select the **Create new** link to create a new subscription instead of selecting existing
       ones.
@@ -333,8 +333,8 @@ Now that the blueprint has been assigned to a subscription, verify the progress
    :::image type="content" source="./media/create-blueprint-portal/view-assignment-details.png" alt-text="View assignment details from the Assigned blueprints page" border="false":::
 
 1. On the **Blueprint assignment** page, validate that all artifacts were successfully deployed and
-   that there were no errors during the deployment. If errors occurred, see [Troubleshooting blueprints](./troubleshoot/general.md)
-   for steps to determine what went wrong.
+   that there were no errors during the deployment. If errors occurred, see
+   [Troubleshooting blueprints](./troubleshoot/general.md) for steps to determine what went wrong.
 
 ## Clean up resources
 
diff --git a/articles/governance/blueprints/create-blueprint-powershell.md b/articles/governance/blueprints/create-blueprint-powershell.md
@@ -1,7 +1,7 @@
 ---
 title: "Quickstart: Create a blueprint with PowerShell"
 description: In this quickstart, you use Azure Blueprints to create, define, and deploy artifacts using the PowerShell.
-ms.date: 05/06/2020
+ms.date: 08/27/2020
 ms.topic: quickstart
 ---
 # Quickstart: Define and Assign an Azure Blueprint with PowerShell
diff --git a/articles/governance/blueprints/how-to/configure-for-blueprint-operator.md b/articles/governance/blueprints/how-to/configure-for-blueprint-operator.md
@@ -1,7 +1,7 @@
 ---
 title: Set up your environment for Blueprint Operator
 description: Learn how to configure your Azure environment for use with the Blueprint Operator Azure built-in role.
-ms.date: 05/06/2020
+ms.date: 08/27/2020
 ms.topic: how-to
 ---
 # Configure your environment for a Blueprint Operator
@@ -24,7 +24,8 @@ level in the management group hierarchy that encompasses all of the management g
 subscriptions the operations team should have blueprint assignment access to. It's recommended to
 follow the principle of least privilege when granting these permissions.
 
-1. (Recommended) [Create a security group and add members](../../../active-directory/fundamentals/active-directory-groups-create-azure-portal.md)
+1. (Recommended)
+   [Create a security group and add members](../../../active-directory/fundamentals/active-directory-groups-create-azure-portal.md)
 
 1. [Add a role assignment](../../../role-based-access-control/role-assignments-portal.md#add-a-role-assignment)
    of **Blueprint Operator** to the account or security group
@@ -55,4 +56,5 @@ of permissions.
 - Understand how to use [static and dynamic parameters](../concepts/parameters.md).
 - Learn to customize the [blueprint sequencing order](../concepts/sequencing-order.md).
 - Find out how to make use of [blueprint resource locking](../concepts/resource-locking.md).
-- Resolve issues during the assignment of a blueprint with [general troubleshooting](../troubleshoot/general.md).
+- Resolve issues during the assignment of a blueprint with
+  [general troubleshooting](../troubleshoot/general.md).
diff --git a/articles/governance/blueprints/how-to/import-export-ps.md b/articles/governance/blueprints/how-to/import-export-ps.md
@@ -1,7 +1,7 @@
 ---
 title: Import and export blueprints with PowerShell
 description: Learn how to work with your blueprint definitions as code. Share, source control, and manage them using the export and import commands.
-ms.date: 05/06/2020
+ms.date: 08/27/2020
 ms.topic: how-to
 ---
 # Import and export blueprint definitions with PowerShell
@@ -141,4 +141,5 @@ For information about creating advanced blueprint definitions, see the following
 - Understand how to use [static and dynamic parameters](../concepts/parameters.md).
 - Learn to customize the [blueprint sequencing order](../concepts/sequencing-order.md).
 - Find out how to make use of [blueprint resource locking](../concepts/resource-locking.md).
-- Resolve issues during the assignment of a blueprint with [general troubleshooting](../troubleshoot/general.md).
+- Resolve issues during the assignment of a blueprint with
+  [general troubleshooting](../troubleshoot/general.md).
diff --git a/articles/governance/blueprints/how-to/manage-assignments-ps.md b/articles/governance/blueprints/how-to/manage-assignments-ps.md
@@ -1,7 +1,7 @@
 ---
 title: How to manage assignments with PowerShell
 description: Learn how to manage blueprint assignments with the official Azure Blueprints PowerShell module, Az.Blueprint.
-ms.date: 05/06/2020
+ms.date: 08/27/2020
 ms.topic: how-to
 ---
 # How to manage assignments with PowerShell
@@ -434,4 +434,5 @@ Remove-AzBlueprintAssignment -InputObject $bpAssignment -SubscriptionId '{subId}
 - Understand how to use [static and dynamic parameters](../concepts/parameters.md).
 - Learn to customize the [blueprint sequencing order](../concepts/sequencing-order.md).
 - Find out how to make use of [blueprint resource locking](../concepts/resource-locking.md).
-- Resolve issues during the assignment of a blueprint with [general troubleshooting](../troubleshoot/general.md).
+- Resolve issues during the assignment of a blueprint with
+  [general troubleshooting](../troubleshoot/general.md).
diff --git a/articles/governance/blueprints/how-to/update-existing-assignments.md b/articles/governance/blueprints/how-to/update-existing-assignments.md
@@ -1,7 +1,7 @@
 ---
 title: Update an existing assignment from the portal
 description: Learn about the mechanism for updating an existing blueprint assignment from the portal in Azure Blueprints.
-ms.date: 04/15/2020
+ms.date: 08/27/2020
 ms.topic: how-to
 ---
 # How to update an existing blueprint assignment
@@ -19,14 +19,14 @@ an existing assignment, including:
 
 1. Select **Assigned blueprints** from the page on the left.
 
-1. In the list of blueprints, left-click the blueprint assignment. Then click the **Update
-   assignment** button OR right-click the blueprint assignment and select **Update assignment**.
+1. In the list of blueprints, select the blueprint assignment. Then use the **Update assignment**
+   button OR right-click the blueprint assignment and select **Update assignment**.
 
    :::image type="content" source="../media/update-existing-assignments/update-assignment.png" alt-text="Update an existing blueprint assignment" border="false":::
 
-1. The **Assign blueprint** page will load pre-filled with all values from the original assignment.
-   You can change the **blueprint definition version**, the **Lock Assignment** state, and any of
-   the dynamic parameters that exist on the blueprint definition. Click **Assign** when done making
+1. The **Assign blueprint** page loads pre-filled with all values from the original assignment. You
+   can change the **blueprint definition version**, the **Lock Assignment** state, and any of the
+   dynamic parameters that exist on the blueprint definition. Select **Assign** when done making
    changes.
 
 1. On the updated assignment details page, see the new status. In this example, we added **Locking**
@@ -80,4 +80,5 @@ error and make another update to the assignment.  Example error scenarios:
 - Understand how to use [static and dynamic parameters](../concepts/parameters.md).
 - Learn to customize the [blueprint sequencing order](../concepts/sequencing-order.md).
 - Find out how to make use of [blueprint resource locking](../concepts/resource-locking.md).
-- Resolve issues during the assignment of a blueprint with [general troubleshooting](../troubleshoot/general.md).
+- Resolve issues during the assignment of a blueprint with
+  [general troubleshooting](../troubleshoot/general.md).
diff --git a/articles/governance/blueprints/index.yml b/articles/governance/blueprints/index.yml
@@ -11,7 +11,7 @@ metadata:
   ms.collection: collection
   author: DCtheGeek
   ms.author: dacoulte
-  ms.date: 06/29/2020
+  ms.date: 08/27/2020
 
 landingContent:
   - title: About Azure Blueprints
diff --git a/articles/governance/blueprints/overview.md b/articles/governance/blueprints/overview.md
@@ -1,7 +1,7 @@
 ---
 title: Overview of Azure Blueprints
 description: Understand how the Azure Blueprints service enables you to create, define, and deploy artifacts in your Azure environment.
-ms.date: 05/06/2020
+ms.date: 08/27/2020
 ms.topic: overview
 ---
 # What is Azure Blueprints?
diff --git a/articles/governance/blueprints/reference/blueprint-functions.md b/articles/governance/blueprints/reference/blueprint-functions.md
@@ -1,7 +1,7 @@
 ---
 title: Azure Blueprints functions
 description: Describes the functions available for use with blueprint artifacts in Azure Blueprints definitions and assignments.
-ms.date: 05/22/2020
+ms.date: 08/27/2020
 ms.topic: reference
 ---
 # Functions for use with Azure Blueprints
@@ -402,4 +402,5 @@ as parameter _resourceName_ to the template artifact.
 - Learn to customize the [blueprint sequencing order](../concepts/sequencing-order.md).
 - Find out how to make use of [blueprint resource locking](../concepts/resource-locking.md).
 - Learn how to [update existing assignments](../how-to/update-existing-assignments.md).
-- Resolve issues during the assignment of a blueprint with [general troubleshooting](../troubleshoot/general.md).
+- Resolve issues during the assignment of a blueprint with
+  [general troubleshooting](../troubleshoot/general.md).
diff --git a/articles/governance/blueprints/samples/nist-sp-800-53-r4.md b/articles/governance/blueprints/samples/nist-sp-800-53-r4.md
diff --git a/articles/governance/blueprints/tutorials/create-from-sample.md b/articles/governance/blueprints/tutorials/create-from-sample.md
diff --git a/articles/governance/blueprints/tutorials/protect-new-resources.md b/articles/governance/blueprints/tutorials/protect-new-resources.md
