Merge pull request #96915 from DCtheGeek/dmc-gov-seoimp3

Update Blueprints for SEO improvements

Author: GitHubber17

articles/governance/blueprints/concepts/lifecycle.md

@@ -1,6 +1,6 @@
 ---
 title: Understand the lifecycle of a blueprint
-description: Learn about the lifecycle that a blueprint goes through and details about each stage.
+description: Learn about the lifecycle that a blueprint definition goes through and details about each stage, including updating and removing blueprint assignments.
 ms.date: 07/30/2019
 ms.topic: conceptual
 ---
@@ -32,25 +32,26 @@ A never published blueprint in **Draft** mode displays a different icon on the *
 Definitions** page than ones that have been **Published**. The **Latest Version** is displayed as
 **Draft** for these never published blueprints.
 
-Create and edit a blueprint with the [Azure portal](../create-blueprint-portal.md#create-a-blueprint)
-or [REST API](../create-blueprint-rest-api.md#create-a-blueprint).
+Create and edit a blueprint with the
+[Azure portal](../create-blueprint-portal.md#create-a-blueprint) or
+[REST API](../create-blueprint-rest-api.md#create-a-blueprint).
 
 ## Publishing a blueprint
 
 Once all planned changes have been made to a blueprint in **Draft** mode, it can be **Published**
-and made available for assignment. The **Published** version of the blueprint can't be altered.
-Once **Published**, the blueprint displays with a different icon than **Draft** blueprints and
-displays the provided version number in the **Latest Version** column.
+and made available for assignment. The **Published** version of the blueprint can't be altered. Once
+**Published**, the blueprint displays with a different icon than **Draft** blueprints and displays
+the provided version number in the **Latest Version** column.
 
 Publish a blueprint with the [Azure portal](../create-blueprint-portal.md#publish-a-blueprint) or
 [REST API](../create-blueprint-rest-api.md#publish-a-blueprint).
 
 ## Creating and editing a new version of the blueprint
 
-A **Published** version of a blueprint can't be altered. However, a new version of the blueprint
-can be added to the existing blueprint and modified as needed. Make changes to an existing
-blueprint by editing it. When the new changes are saved, the blueprint now has **Unpublished
-Changes**. These changes are a new **Draft** version of the blueprint.
+A **Published** version of a blueprint can't be altered. However, a new version of the blueprint can
+be added to the existing blueprint and modified as needed. Make changes to an existing blueprint by
+editing it. When the new changes are saved, the blueprint now has **Unpublished Changes**. These
+changes are a new **Draft** version of the blueprint.
 
 Edit a blueprint with the [Azure portal](../create-blueprint-portal.md#edit-a-blueprint).
 
@@ -62,7 +63,8 @@ Blueprint** button is available on the edit blueprint page. If the button isn't
 blueprint has already been **Published** and has no **Unpublished Changes**.
 
 > [!NOTE]
-> A single blueprint can have multiple **Published** versions that can each be assigned to subscriptions.
+> A single blueprint can have multiple **Published** versions that can each be assigned to
+> subscriptions.
 
 To publish a blueprint with **Unpublished Changes**, use the same steps for publishing a new
 blueprint.
@@ -74,27 +76,28 @@ version of a blueprint can also be deleted. Deleting a version of a blueprint do
 impact on other versions of that blueprint.
 
 > [!NOTE]
-> It's not possible to delete a blueprint that has active assignments. Delete the
-> assignments first and then delete the version you wish to remove.
+> It's not possible to delete a blueprint that has active assignments. Delete the assignments first
+> and then delete the version you wish to remove.
 
 1. Select **All services** in the left pane. Search for and select **Blueprints**.
 
-1. Select **Blueprint definitions** from the page on the left and use the filter options to locate the blueprint you want to delete a version of. Click on it to open the edit page.
+1. Select **Blueprint definitions** from the page on the left and use the filter options to locate
+   the blueprint you want to delete a version of. Select it to open the edit page.
 
-1. Click the **Published versions** tab and locate the version you wish to delete.
+1. Select the **Published versions** tab and locate the version you wish to delete.
 
 1. Right-click on the version to delete and select **Delete this version**.
 
 ## Deleting the blueprint
 
 The core blueprint can also be deleted. Deleting the core blueprint also deletes any blueprint
 versions of that blueprint, including both **Draft** and **Published** blueprints. As with deleting
-a version of a blueprint, deleting the core blueprint doesn't remove the existing assignments of
-any of the blueprint versions.
+a version of a blueprint, deleting the core blueprint doesn't remove the existing assignments of any
+of the blueprint versions.
 
 > [!NOTE]
-> It's not possible to delete a blueprint that has active assignments. Delete the
-> assignments first and then delete the version you wish to remove.
+> It's not possible to delete a blueprint that has active assignments. Delete the assignments first
+> and then delete the version you wish to remove.
 
 Delete a blueprint with the [Azure portal](../create-blueprint-portal.md#delete-a-blueprint) or
 [REST API](../create-blueprint-rest-api.md#delete-a-blueprint).
@@ -106,9 +109,9 @@ mode of a version of the blueprint is **Published**, then that version can be as
 subscription. This lifecycle enables versions of a blueprint to be used and actively assigned while
 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).
+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).
 
 ### Updating assignments
 

articles/governance/blueprints/concepts/resource-locking.md

@@ -1,15 +1,15 @@
 ---
 title: Understand resource locking
-description: Learn about the locking options to protect resources when assigning a blueprint.
+description: Learn about the locking options in Azure Blueprints to protect resources when assigning a blueprint.
 ms.date: 04/24/2019
 ms.topic: conceptual
 ---
 # Understand resource locking in Azure Blueprints
 
 The creation of consistent environments at scale is only truly valuable if there's a mechanism to
 maintain that consistency. This article explains how resource locking works in Azure Blueprints. To
-see an example of resource locking and application of _deny assignments_, see the [protecting new resources](../tutorials/protect-new-resources.md)
-tutorial.
+see an example of resource locking and application of _deny assignments_, see the
+[protecting new resources](../tutorials/protect-new-resources.md) tutorial.
 
 ## Locking modes and states
 
@@ -55,8 +55,8 @@ is left behind and would need to be deleted through normal means.
 ## How blueprint locks work
 
 An RBAC [deny assignments](../../../role-based-access-control/deny-assignments.md) deny action is
-applied to artifact resources during assignment of a blueprint if the assignment selected the
-**Read Only** or **Do Not Delete** option. The deny action is added by the managed identity of the
+applied to artifact resources during assignment of a blueprint if the assignment selected the **Read
+Only** or **Do Not Delete** option. The deny action is added by the managed identity of the
 blueprint assignment and can only be removed from the artifact resources by the same managed
 identity. This security measure enforces the locking mechanism and prevents removing the blueprint
 lock outside Blueprints.
@@ -80,10 +80,12 @@ of each mode are as follows:
 
 ## Exclude a principal from a deny assignment
 
-In some design or security scenarios, it may be necessary to exclude a principal from the [deny assignment](../../../role-based-access-control/deny-assignments.md)
-the blueprint assignment creates. This is done in REST API by adding up to five values to the
-**excludedPrincipals** array in the **locks** property when [creating the assignment](/rest/api/blueprints/assignments/createorupdate).
-This is an example of a request body that includes **excludedPrincipals**:
+In some design or security scenarios, it may be necessary to exclude a principal from the
+[deny assignment](../../../role-based-access-control/deny-assignments.md) the blueprint assignment
+creates. This is done in REST API by adding up to five values to the **excludedPrincipals** array in
+the **locks** property when
+[creating the assignment](/rest/api/blueprints/assignments/createorupdate). This is an example of a
+request body that includes **excludedPrincipals**:
 
 ```json
 {

articles/governance/blueprints/how-to/configure-for-blueprint-operator.md

@@ -1,5 +1,5 @@
 ---
-title: Configure your environment for a Blueprint Operator
+title: Setup your environment for Blueprint Operator
 description: Learn how to configure your Azure environment for use with the Blueprint Operator built-in role-based access control (RBAC) role.
 ms.date: 08/26/2019
 ms.topic: conceptual

articles/governance/blueprints/how-to/import-export-ps.md

@@ -1,5 +1,5 @@
 ---
-title: Import and export blueprint definitions with PowerShell
+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: 09/03/2019
 ms.topic: conceptual

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 assignment from the portal in Azure Blueprints.
-ms.date: 10/25/2018
+description: Learn about the mechanism for updating an existing blueprint assignment from the portal in Azure Blueprints.
+ms.date: 11/21/2019
 ms.topic: conceptual
 ---
 # How to update an existing blueprint assignment
@@ -19,17 +19,23 @@ 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, left-click the blueprint assignment. Then click the **Update
+   assignment** button OR right-click the blueprint assignment and select **Update assignment**.
 
    ![Update an existing blueprint assignment](../media/update-existing-assignments/update-assignment.png)
 
-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 changes.
+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
+   changes.
 
-1. On the updated assignment details page, see the new status. In this example, we added **Locking** to the assignment.
+1. On the updated assignment details page, see the new status. In this example, we added **Locking**
+   to the assignment.
 
    ![Updated an existing blueprint assignment - lock mode changed](../media/update-existing-assignments/updated-assignment.png)
 
-1. Explore details about other **Assignment operations** using the drop-down. The table of **Managed resources** updates by selected assignment operation.
+1. Explore details about other **Assignment operations** using the drop-down. The table of **Managed
+   resources** updates by selected assignment operation.
 
    ![Assignment operations of a blueprint assignment](../media/update-existing-assignments/assignment-operations.png)
 
@@ -40,13 +46,18 @@ happens to already deployed resources. The requested change and the type of arti
 deployed or updated determine which actions are taken.
 
 - Role Assignments
-  - If the role or the role assignee (user, group, or app) changes, a new role assignment is created. Role assignments previously deployed are left in place.
+  - If the role or the role assignee (user, group, or app) changes, a new role assignment is
+    created. Role assignments previously deployed are left in place.
 - Policy Assignments
   - If the parameters of the policy assignment are changed, the existing assignment is updated.
-  - If the definition of the policy assignment is changed, a new policy assignment is created. Policy assignments previously deployed are left in place.
-  - If the policy assignment artifact is removed from the blueprint, deployed policy assignments are left in place.
+  - If the definition of the policy assignment is changed, a new policy assignment is created.
+    Policy assignments previously deployed are left in place.
+  - If the policy assignment artifact is removed from the blueprint, deployed policy assignments are
+    left in place.
 - Azure Resource Manager templates
-  - The template is processed through Resource Manager as a **PUT**. As each resource type handles this action differently, review the documentation for each included resource to determine the impact of this action when run by Blueprints.
+  - The template is processed through Resource Manager as a **PUT**. As each resource type handles
+    this action differently, review the documentation for each included resource to determine the
+    impact of this action when run by Blueprints.
 
 ## Possible errors on updating assignments
 

articles/governance/blueprints/samples/caf-foundation/index.md

@@ -1,6 +1,6 @@
 ---
 title: CAF Foundation blueprint sample - Overview
-description: Overview and architecture of the CAF Foundation blueprint sample.
+description: Overview and architecture of the Cloud Adoption Framework (CAF) for Azure Foundation blueprint sample.
 ms.date: 08/20/2019
 ms.topic: sample
 ---
@@ -22,26 +22,27 @@ organization to confidently get started with Azure.
 This implementation incorporates several Azure services used to provide a secure, fully monitored,
 enterprise-ready foundation. This environment is composed of:
 
-- An [Azure Key Vault](../../../../key-vault/key-vault-overview.md) instance used to host secrets used
-  for the VMs deployed in the shared services environment
+- An [Azure Key Vault](../../../../key-vault/key-vault-overview.md) instance used to host secrets
+  used for the VMs deployed in the shared services environment
 - Deploy [Log Analytics](../../../../azure-monitor/overview.md) is deployed to ensure all actions
-  and services log to a central location from the moment you start your secure deployment in to [Storage Accounts](../../../../storage/common/storage-introduction.md)
-  for diagnostic logging
+  and services log to a central location from the moment you start your secure deployment in to
+  [Storage Accounts](../../../../storage/common/storage-introduction.md) for diagnostic logging
 - Deploy [Azure Security Center](../../../../security-center/security-center-intro.md) (standard
   version) provides threat protection for your migrated workloads
 - The blueprint also defines and deploys [Azure Policies](../../../policy/overview.md), for 
   - Tagging (CostCenter) applied to resources groups
   - Append resources in resource group with the CostCenter Tag
   - Allowed Azure Region for Resources and Resource Groups
   - Allowed Storage Account SKUs (choose while deploying)
-  - Allowed Azure VM SKUs	(choose while deploying)
+  - Allowed Azure VM SKUs (choose while deploying)
   - Require Network Watch to be deployed 
   - Require Azure Storage Account Secure transfer Encryption
   - Deny resource types (choose while deploying)  
 - Initiatives
   - Enable Monitoring in Azure Security Center (89 Policies)
 
-All these elements abide to the proven practices published in the [Azure Architecture Center - Reference Architectures](/azure/architecture/reference-architectures/).
+All these elements abide to the proven practices published in the
+[Azure Architecture Center - Reference Architectures](/azure/architecture/reference-architectures/).
 
 > [!NOTE]
 > The CAF Foundation lays out a foundational architecture for workloads.
@@ -55,7 +56,7 @@ For more information, see the
 You've reviewed the overview and architecture of the CAF Foundation blueprint sample.
 
 > [!div class="nextstepaction"]
->  [CAF Foundation blueprint - Deploy steps](./deploy.md)
+> [CAF Foundation blueprint - Deploy steps](./deploy.md)
 
 Additional articles about blueprints and how to use them:
 

articles/governance/blueprints/samples/caf-migrate-landing-zone/index.md

@@ -1,6 +1,6 @@
 ---
 title: CAF Migration landing zone blueprint sample - Overview
-description: Overview and architecture of the CAF Migration landing zone blueprint sample.
+description: Overview and architecture of the Cloud Adoption Framework (CAF) for Azure Migration landing zone blueprint sample.
 ms.date: 08/20/2019
 ms.topic: sample
 ---
@@ -25,8 +25,8 @@ confidently get started with Azure.
 This environment is composed of several Azure services used to provide a secure, fully monitored,
 enterprise-ready governance. This environment is composed of:
 
-- An [Azure Key Vault](../../../../key-vault/key-vault-overview.md) instance used to host secrets used
-  for the Certificates, Keys, and Secrets deployed in the shared services environment
+- An [Azure Key Vault](../../../../key-vault/key-vault-overview.md) instance used to host secrets
+  used for the Certificates, Keys, and Secrets deployed in the shared services environment
 - Deploy [Log Analytics](../../../../azure-monitor/overview.md) is deployed to ensure all actions
   and services log to a central location from the moment you start your migration
 - Deploy [Azure Security Center](../../../../security-center/security-center-intro.md) (standard
@@ -38,21 +38,23 @@ enterprise-ready governance. This environment is composed of:
   and Database migration.  
 
 
-All these elements abide to the proven practices published in the [Azure Architecture Center - Reference Architectures](/azure/architecture/reference-architectures/).
+All these elements abide to the proven practices published in the
+[Azure Architecture Center - Reference Architectures](/azure/architecture/reference-architectures/).
 
 > [!NOTE]
 > The CAF Migration blueprint lays out a landing zone for your workloads. You still need to perform
 > the assessment and migration of your Virtual Machines / Databases on top of this foundational
 > architecture.
 
-For more information, see the [Microsoft Cloud Adoption Framework for Azure - Migrate](/azure/architecture/cloud-adoption/migrate/).
+For more information, see the
+[Microsoft Cloud Adoption Framework for Azure - Migrate](/azure/architecture/cloud-adoption/migrate/).
 
 ## Next steps
 
 You've reviewed the overview and architecture of the CAF Migrate landing zone blueprint sample.
 
 > [!div class="nextstepaction"]
->  [CAF Migration landing zone blueprint - Deploy steps](./deploy.md)
+> [CAF Migration landing zone blueprint - Deploy steps](./deploy.md)
 
 Additional articles about blueprints and how to use them:
 

articles/governance/blueprints/samples/canada-federal-pbmm/deploy.md

@@ -2,7 +2,7 @@
 title: Canada Federal PBMM blueprint sample - Deploy steps
 description: Deploy steps for the Canada Federal PBMM blueprint sample including blueprint artifact parameter details.
 ms.date: 09/05/2019
-ms.topic: conceptual
+ms.topic: sample
 ---
 # Deploy the Canada Federal PBMM blueprint samples
 

articles/governance/blueprints/samples/canada-federal-pbmm/index.md

@@ -35,4 +35,4 @@ Additional articles about blueprints and how to use them:
 - 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).
-- Learn how to [update existing assignments](../../how-to/update-existing-assignments.md).
+- Learn how to [update existing assignments](../../how-to/update-existing-assignments.md).