copy edit

Author: tfitzmac

articles/azure-resource-manager/management/create-private-link-access-portal.md

@@ -2,7 +2,7 @@
 title: Create private link for managing resources - Azure portal
 description: Use Azure portal to create private link for managing resources.
 ms.topic: conceptual
-ms.date: 09/26/2024
+ms.date: 02/09/2025
 ---
 
 # Use portal to create private link for managing Azure resources
@@ -13,7 +13,7 @@ This article explains how to use [Azure Private Link](../../private-link/index.y
 
 ## Create resource management private link
 
-When you create a resource management private link, the private link association is automatically created for you.
+When you create a resource management private link, the portal automatically creates the private link association for you.
 
 1. In the [portal](https://portal.azure.com), search for **Resource management private links** and select it from the available options.
 

articles/azure-resource-manager/management/delete-resource-group.md

@@ -1,8 +1,8 @@
 ---
-title: Delete resource group and resources
-description: Describes how to delete resource groups and resources. It describes how Azure Resource Manager orders the deletion of resources when a deleting a resource group. It describes the response codes and how Resource Manager handles them to determine if the deletion succeeded.
+title: Delete Resource Groups and Resources
+description: Describes how to delete resource groups and resources. It describes how Azure Resource Manager orders the deletion of resources when you delete a resource group. It describes the response codes and how Resource Manager handles them to determine if the deletion succeeded.
 ms.topic: conceptual
-ms.date: 09/26/2024
+ms.date: 02/09/2025
 ms.custom: devx-track-arm-template
 content_well_notification: 
   - AI-contribution
@@ -17,7 +17,7 @@ This article shows how to delete resource groups and resources. It describes how
 > To delete a resource group, you must first remove any underlying resource locks and backup data.
 >
 
-## How order of deletion is determined
+## How Resource Manager determines the order of deletion
 
 When you delete a resource group, Resource Manager determines the order to delete resources. It uses the following order:
 
@@ -27,7 +27,7 @@ When you delete a resource group, Resource Manager determines the order to delet
 
 3. The remaining resources are deleted after the previous two categories.
 
-After the order is determined, Resource Manager issues a DELETE operation for each resource. It waits for any dependencies to finish before proceeding.
+After Resource Manager determines the order, it issues a DELETE operation for each resource. It waits for any dependencies to finish before proceeding.
 
 For synchronous operations, the expected successful response codes are:
 
@@ -36,18 +36,17 @@ For synchronous operations, the expected successful response codes are:
 * 404
 
 For asynchronous operations, the expected successful response is 202. Resource Manager tracks the location header or the azure-async operation header to determine the status of the asynchronous delete operation.
-  
 ### Deletion errors
 
-When a delete operation returns an error, Resource Manager retries the DELETE call. Retries happen for the 5xx, 429 and 408 status codes. By default, the time period for retry is 15 minutes.
+When a delete operation returns an error, Resource Manager retries the DELETE call. Retries happen for the 5xx, 429, and 408 status codes. By default, the time period for retry is 15 minutes.
 
 ## After deletion
 
-Resource Manager issues a GET call on each resource that it tried to delete. The response of this GET call is expected to be 404. When Resource Manager gets a 404, it considers the deletion to have completed successfully. Resource Manager removes the resource from its cache.
+Resource Manager issues a GET call on each resource that it tried to delete. The response of this GET call is expected to be 404. When Resource Manager gets a 404, it considers the deletion to be successful. Resource Manager removes the resource from its cache.
 
 However, if the GET call on the resource returns a 200 or 201, Resource Manager recreates the resource.
 
-If the GET operation returns an error, Resource Manager retries the GET for the following error code:
+If the GET operation returns an error, Resource Manager retries the GET for the following error codes:
 
 * Less than 100
 * 408
@@ -57,11 +56,11 @@ If the GET operation returns an error, Resource Manager retries the GET for the
 For other error codes, Resource Manager fails the deletion of the resource.
 
 > [!IMPORTANT]
-> Resource Group deletion is irreversible.
+> Resource group deletion is irreversible.
 
 ## Delete resource group
 
-Use one of the following methods to delete the resource group.
+To delete the resource group, use one of the following methods.
 
 # [PowerShell](#tab/azure-powershell)
 
@@ -81,9 +80,9 @@ az group delete --name ExampleResourceGroup
 
 1. Select **Delete resource group**.
 
-   :::image type="content" source="./media/delete-resource-group/delete-group.png" alt-text="Screenshot of the Delete resource group button in the Azure portal.":::
+   :::image type="content" source="./media/delete-resource-group/delete-group.png" alt-text="Screenshot of the 'Delete resource group' button in the Azure portal.":::
 
-1. To confirm the deletion, type the name of the resource group
+1. To confirm the deletion, type the name of the resource group.
 
 # [Python](#tab/azure-python)
 
@@ -104,7 +103,7 @@ rg_result = resource_client.resource_groups.begin_delete("exampleGroup")
 
 ## Delete resource
 
-Use one of the following methods to delete a resource.
+To delete a resource, use one of the following methods.
 
 # [PowerShell](#tab/azure-powershell)
 
@@ -164,34 +163,34 @@ resource_client.resources.begin_delete_by_id(
 To delete a resource group, you need access to the delete action for the **Microsoft.Resources/subscriptions/resourceGroups** resource.
 
 > [!IMPORTANT]
-> The only permission required to delete a resource group is permission to the delete action for deleting resource groups.  You do **not** need permission to delete individual resources within that resource group.  Additionally, delete actions that are specified in **notActions** for a roleAssignment are superseded by the resource group delete action.  This is consistent with the scope hierarchy in the Azure role-based access control model.
+> The only permission required to delete a resource group is permission to the delete action for deleting resource groups. You don't need permission to delete individual resources within that resource group. Additionally, delete actions that are specified in **notActions** for a roleAssignment are superseded by the resource group delete action. This requirement is consistent with the scope hierarchy in the Azure role-based access control model.
 
 For a list of operations, see [Azure resource provider operations](../../role-based-access-control/resource-provider-operations.md). For a list of built-in roles, see [Azure built-in roles](../../role-based-access-control/built-in-roles.md).
 
-If you have the required access, but the delete request fails, it may be because there's a [lock on the resources or resource group](lock-resources.md). Even if you didn't manually lock a resource group, [a related service may have automatically locked it](lock-resources.md#managed-applications-and-locks). Or, the deletion can fail if the resources are connected to resources in other resource groups that aren't being deleted. For example, you can't delete a virtual network with subnets that are still in use by a virtual machine.
+If you have the required access, but the delete request fails, it might be because there's a [lock on the resources or resource group](lock-resources.md). Even if you didn't manually lock a resource group, [a related service might automatically lock it](lock-resources.md#managed-applications-and-locks). Or, the deletion can fail if the resources are connected to resources in other resource groups that aren't being deleted. For example, you can't delete a virtual network with subnets that a virtual machine uses.
 
 ## Can I recover a deleted resource group?
 
 No, you can't recover a deleted resource group. However, you might be able to restore some recently deleted resources.
 
 Some resource types support *soft delete*. You might have to configure soft delete before you can use it. For information about enabling soft delete, see:
 
-* [Azure Key Vault soft-delete overview](/azure/key-vault/general/soft-delete-overview)
-* [Azure Storage - Soft delete for containers](../../storage/blobs/soft-delete-container-overview.md)
-* [Azure Storage - Soft delete for blobs](../../storage/blobs/soft-delete-blob-overview.md)
+* [Soft-delete overview - Azure Key Vault](/azure/key-vault/general/soft-delete-overview)
+* [Soft delete for containers - Azure Storage](../../storage/blobs/soft-delete-container-overview.md)
+* [Soft delete for blobs - Azure Storage](../../storage/blobs/soft-delete-blob-overview.md)
 * [Soft delete for Azure Backup](../../backup/backup-azure-security-feature-cloud.md)
 * [Soft delete for SQL server in Azure VM and SAP HANA in Azure VM workloads](../../backup/soft-delete-sql-saphana-in-azure-vm.md)
 * [Soft delete for virtual machines](../..//backup/soft-delete-virtual-machines.md)
 
 To restore deleted resources, see:
 
 * [Recover deleted Azure AI services resources](/azure/ai-services/manage-resources)
-* [Microsoft Entra - Recover from deletions](../../active-directory/architecture/recover-from-deletions.md)
+* [Recover from deletions - Microsoft Entra](../../active-directory/architecture/recover-from-deletions.md)
 
 You can also [open an Azure support case](/azure/azure-portal/supportability/how-to-create-azure-support-request). Provide as much detail as you can about the deleted resources, including their resource IDs, types, and resource names. Request that the support engineer check if the resources can be restored.
 
 > [!NOTE]
-> Recovery of deleted resources is not possible under all circumstances. A support engineer will investigate your scenario and advise you whether it's possible.
+> Recovery of deleted resources isn't possible under all circumstances. A support engineer investigates your scenario and advises you whether it's possible.
 
 ## Next steps
 

articles/azure-resource-manager/management/extension-resource-types.md

@@ -1,13 +1,13 @@
 ---
-title: Extension resource types
-description: Lists the Azure resource types are used to extend the capabilities of other resource types.
+title: Extension Resource Types
+description: Lists the Azure resource types that you use to extend the capabilities of other resource types.
 ms.topic: conceptual
-ms.date: 07/24/2024
+ms.date: 02/09/2025
 ---
 
 # Resource types that extend capabilities of other resources
 
-An extension resource is a resource that adds to another resource's capabilities. For example, resource lock is an extension resource. You apply a resource lock to another resource to prevent it from being deleted or modified. It doesn't make sense to create a resource lock by itself. An extension resource is always applied to another resource.
+An extension resource is a resource that adds to another resource's capabilities. For example, resource lock is an extension resource. You apply a resource lock to another resource to prevent it from being deleted or modified. It doesn't make sense to create a resource lock by itself. You always apply an extension resource to another resource.
 
 ## Microsoft.Advisor
 

articles/azure-resource-manager/management/manage-private-link-access-commands.md

@@ -1,14 +1,14 @@
 ---
-title: Manage resource management private links
+title: Manage Resource Management Private Links
 description: Use APIs to manage existing resource management private links
 ms.topic: conceptual
 ms.custom: devx-track-azurecli, devx-track-azurepowershell
-ms.date: 09/26/2024
+ms.date: 02/09/2025
 ---
 
 # Manage resource management private links
 
-This article explains how you to work with existing resource management private links. It shows API operations for getting and deleting existing resources.
+This article explains how to work with existing resource management private links. It shows API operations for getting and deleting existing resources.
 
 If you need to create a resource management private link, see [Use portal to create private link for managing Azure resources](create-private-link-access-portal.md) or [Use APIs to create private link for managing Azure resources](create-private-link-access-commands.md).
 

articles/azure-resource-manager/management/manage-resource-groups-cli.md

@@ -1,27 +1,27 @@
 ---
-title: Manage resource groups - Azure CLI
+title: Manage Resource Groups - Azure CLI
 description: Use Azure CLI to manage your resource groups through Azure Resource Manager. Shows how to create, list, and delete resource groups.
 author: mumian
 ms.topic: conceptual
-ms.date: 09/26/2024
+ms.date: 02/09/2025
 ms.custom: devx-track-azurecli, devx-track-arm-template
 ---
 
-# Manage Azure Resource Groups by using Azure CLI
+# Manage Azure resource groups by using Azure CLI
 
-Learn how to use Azure CLI with [Azure Resource Manager](overview.md) to manage your Azure resource groups. For managing Azure resources, see [Manage Azure resources by using Azure CLI](manage-resources-cli.md).
+Learn how to use Azure CLI with [Azure Resource Manager](overview.md) to manage your Azure resource groups.
 
 ## Prerequisites
 
 * Azure CLI. For more information, see [How to install the Azure CLI](/cli/azure/install-azure-cli).
 
-* After installing, sign in for the first time. For more information, see [How to sign in to the Azure CLI](/cli/azure/get-started-with-azure-cli#how-to-sign-into-the-azure-cli).
+* An authenticated account. After installing Azure CLI, sign in for the first time. For more information, see [How to sign in to the Azure CLI](/cli/azure/get-started-with-azure-cli#how-to-sign-into-the-azure-cli).
 
 ## What is a resource group
 
-A resource group is a container that holds related resources for an Azure solution. The resource group can include all the resources for the solution, or only those resources that you want to manage as a group. You decide how you want to add resources to resource groups based on what makes the most sense for your organization. Generally, add resources that share the same lifecycle to the same resource group so you can easily deploy, update, and delete them as a group.
+A resource group is a container that holds related resources for an Azure solution. The resource group can include all the resources for the solution, or only those resources that you want to manage as a group. You decide how to add resources to resource groups based on what makes the most sense for your organization. Generally, add resources that share the same lifecycle to the same resource group so you can easily deploy, update, and delete them as a group.
 
-The resource group stores metadata about the resources. When you specify a location for the resource group, you're specifying where that metadata is stored. For compliance reasons, you may need to ensure that your data is stored in a particular region.
+The resource group stores metadata about the resources. When you specify a location for the resource group, you're specifying where that metadata is stored. For compliance reasons, you might need to ensure that your data is stored in a particular region.
 
 ## Create resource groups
 
@@ -139,5 +139,6 @@ To manage access to a resource group, use [Azure role-based access control (Azur
 
 ## Next steps
 
+* To manage Azure resources, see [Manage Azure resources by using Azure CLI](manage-resources-cli.md).
 * To learn Azure Resource Manager, see [Azure Resource Manager overview](overview.md).
 * To learn the Resource Manager template syntax, see [Understand the structure and syntax of Azure Resource Manager templates](../templates/syntax.md).

articles/azure-resource-manager/management/manage-resource-groups-portal.md

@@ -1,14 +1,14 @@
 ---
-title: Use the Azure portal and Azure Resource Manager to manage resource groups
+title: Use the Azure portal and Azure Resource Manager to Manage Resource Groups
 description: Learn how to use the Azure portal and Azure Resource Manager to manage your resource groups. Understand how to create, list, and delete resource groups.
 ms.topic: conceptual
-ms.date: 01/23/2025
+ms.date: 02/09/2025
 ms.custom: devx-track-arm-template
 ---
 
 # Use the Azure portal and Azure Resource Manager to manage resource groups
 
-Learn how to use the [Azure portal](https://portal.azure.com) with [Azure Resource Manager](overview.md) to manage Azure resource groups. See [Manage Azure resources by using the Azure portal](manage-resources-portal.md) to learn more about managing Azure resources.
+Learn how to use the [Azure portal](https://portal.azure.com) with [Azure Resource Manager](overview.md) to manage Azure resource groups.
 
 [!INCLUDE [Handle personal data](~/reusable-content/ce-skilling/azure/includes/gdpr-intro-sentence.md)]
 
@@ -39,11 +39,11 @@ The resource group stores metadata about the resources. When you specify a locat
    - **Resource group**: Enter a new resource group name.
    - **Region**: Select an Azure location such as **Central US**.
 
-     :::image type="content" source="./media/manage-resource-groups-portal/manage-resource-groups-create-group.png" alt-text="Screenshot of the Create Resource Group form in the Azure portal with fields for Subscription, Resource group, and Region." lightbox="./media/manage-resource-groups-portal/manage-resource-groups-create-group.png":::
+     :::image type="content" source="./media/manage-resource-groups-portal/manage-resource-groups-create-group.png" alt-text="Screenshot of the 'Create Resource Group' form in the Azure portal with fields for Subscription, Resource group, and Region." lightbox="./media/manage-resource-groups-portal/manage-resource-groups-create-group.png":::
 
 1. Select **Review + Create**.
 1. Select **Create**. It takes a few seconds to create a resource group.
-1. Select **Refresh** from the top menu to refresh the resource group list, and then select the newly created resource group to open it. Or, select **Notification** (the bell icon) from the top, and then select **Go to resource group** to open the newly created resource group.
+1. To refresh the resource group list, select **Refresh** from the top menu. To open the newly created resource group, select it from the list. Or, select **Notification** (the bell icon) from the top, and then select **Go to resource group** to open the newly created resource group.
 
     :::image type="content" source="./media/manage-resource-groups-portal/manage-resource-groups-add-group-go-to-resource-group.png" alt-text="Screenshot of the Azure portal with the 'Go to resource group' button in the Notifications panel." lightbox="./media/manage-resource-groups-portal/manage-resource-groups-add-group-go-to-resource-group.png":::
 
@@ -76,7 +76,7 @@ After you create a Resource Manager template, use the Azure portal to deploy you
 
 ## Move to another resource group or subscription
 
-You can move resources from one resource group to another. See [Move Azure resources to a new resource group or subscription](move-resource-group-and-subscription.md) for more information and guidance.
+You can move resources from one resource group to another. For more information and guidance, see [Move Azure resources to a new resource group or subscription](move-resource-group-and-subscription.md).
 
 ## Lock resource groups
 
@@ -105,7 +105,8 @@ Use [Azure role-based access control (Azure RBAC)](../../role-based-access-contr
 
 ## Next steps
 
+- To learn more about managing Azure resources, see [Manage Azure resources by using the Azure portal](manage-resources-portal.md).
 - To learn more about Resource Manager, see the [What is Azure Resource Manager?](overview.md) overview.
 - To learn the Resource Manager template syntax, see [Understand the structure and syntax of Azure Resource Manager templates](../templates/syntax.md).
-- To learn how to develop templates, see the step-by-step [Azure Resource Manager documentation tutorials](../index.yml) from Learn.
+- To learn how to develop templates, see the step-by-step [Azure Resource Manager documentation tutorials](../index.yml).
 - To view Azure Resource Manager template schemas, see [Define resources with Bicep, ARM templates, and Terraform AzAPI provider](/azure/templates/).