acrolinx edits to get score > 80 in sub-categories

Author: Larry Franks

articles/machine-learning/how-to-manage-registries.md

@@ -1,7 +1,7 @@
 ---
 title: Create and manage registries (preview)
 titleSuffix: Azure Machine Learning
-description: Learn how create registries with the CLI, REST API, Azure portal and Azure Machine Learning Studio 
+description: Learn how create registries with the CLI, REST API, Azure portal and Azure Machine Learning studio 
 services: machine-learning
 ms.service: machine-learning
 ms.subservice: mlops
@@ -22,7 +22,7 @@ Azure Machine Learning entities can be grouped into two broad categories:
 
 Assets lend themselves to being stored in a central repository and used in different workspaces, possibly in different regions. Resources are workspace specific. 
 
-Azure Machine Learning registries (preview) enable you to create and use those assets in different workspaces. Registries support multi-region replication for low latency access to assets, so you can use assets in workspaces located in different Azure regions. Creating a registry will provision Azure resources required to facilitate replication. First, Azure blob storage accounts in each supported region. Second, a single Azure Container Registry with replication enabled to each supported region. 
+Azure Machine Learning registries (preview) enable you to create and use those assets in different workspaces. Registries support multi-region replication for low latency access to assets, so you can use assets in workspaces located in different Azure regions. Creating a registry provisions Azure resources required to facilitate replication. First, Azure blob storage accounts in each supported region. Second, a single Azure Container Registry with replication enabled to each supported region. 
 
 :::image type="content" source="./media/how-to-manage-registries/machine-learning-registry-block-diagram.png" alt-text="Diagram of the relationships between assets in workspace and registry.":::
 
@@ -94,7 +94,7 @@ You can create registries in Azure Machine Learning studio using the following s
     > If you are in a workspace, navigate to the global UI by clicking your organization or tenant name in the navigation pane to find the __Registries__ entry.  You can also go directly there by navigating to [https://ml.azure.com/registries](https://ml.azure.com/registries).
 
     :::image type="content" source="./media/how-to-manage-registries/studio-create-registry-button.png" lightbox="./media/how-to-manage-registries/studio-create-registry-button.png" alt-text="Screenshot of the create registry screen.":::
-	
+    
 1. Enter the registry name, select the subscription and resource group and then select __Next__.
 
     :::image type="content" source="./media/how-to-manage-registries/studio-create-registry-basics.png" alt-text="Screenshot of the registry creation basics tab.":::
@@ -111,7 +111,7 @@ You can create registries in Azure Machine Learning studio using the following s
 1. From the [Azure portal](https://portal.azure.com), navigate to the Azure Machine Learning service. You can get there by searching for __Azure Machine Learning__ in the search bar at the top of the page or going to __All Services__ looking for __Azure Machine Learning__ under the __AI + machine learning__ category. 
 
 1. Select __Create__, and then select __Azure Machine Learning registry__. Enter the registry name, select the subscription, resource group and primary region, then select __Next__.
-	
+    
 1. Select the additional regions the registry must support, then select __Next__ until you arrive at the __Review + Create__ tab.
 
     :::image type="content" source="./media/how-to-manage-registries/create-registry-review.png" alt-text="Screenshot of the review + create tab.":::
@@ -122,15 +122,19 @@ You can create registries in Azure Machine Learning studio using the following s
 
 # [REST API](#tab/rest)
 
-You will require the **curl** utility to  complete this step. The **curl** program is available in the [Windows Subsystem for Linux](/windows/wsl/install-win10) or any UNIX distribution. In PowerShell, **curl** is an alias for **Invoke-WebRequest** and `curl -d "key=val" -X POST uri` becomes `Invoke-WebRequest -Body "key=val" -Method POST -Uri uri`.  
+> [!TIP]
+> You need the **curl** utility to complete this step. The **curl** program is available in the [Windows Subsystem for Linux](/windows/wsl/install-win10) or any UNIX distribution. In PowerShell, **curl** is an alias for **Invoke-WebRequest** and `curl -d "key=val" -X POST uri` becomes `Invoke-WebRequest -Body "key=val" -Method POST -Uri uri`.  
 
-You will also require an authentication token for your account to complete the REST API call. You can use below command to retrieve the token:
+To authenticate REST API calls, you need an authentication token for your Azure user account. You can use the following command to retrieve a token:
 
 ```azurecli
 az account get-access-token 
 ```
 
-The response should provide an access token good for one hour. Make note of the token, as you will use it to authenticate all administrative requests.  Below is a sample response:
+The response should provide an access token good for one hour. Make note of the token, as you use it to authenticate all administrative requests. The following JSON is a sample response:
+
+> [!TIP]
+> The value of the `access_token` field is the token.
 
 ```json
 {
@@ -142,7 +146,7 @@ The response should provide an access token good for one hour. Make note of the
 }
 ```
 
-Run below command to create a registry. You can edit the Json to change the inputs as needed:
+To create a registry, use the following command. You can edit the JSON to change the inputs as needed. Replace the `<YOUR-ACCESS-TOKEN>` value with the access token retrieved previously:
 
 ```bash
 curl -X PUT https://management.azure.com/subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group>/providers/Microsoft.MachineLearningServices/registries/reg-from-rest?api-version=2022-12-01-preview -H "Authorization:Bearer <YOUR-ACCESS-TOKEN>" -H 'Content-Type: application/json' -d ' 
@@ -197,7 +201,7 @@ Next, decide if you want to use an [Azure Blob storage](../storage/blobs/storage
 > [!NOTE]
 >The `hns` portion of `storage_account_hns` refers to the [hierarchical namespace](../storage/blobs/data-lake-storage-namespace.md) capability of Azure Data Lake Storage Gen2 accounts.
 
-Below is an example YAML that demonstrates this advanced storage configuration:
+The following example YAML file demonstrates this advanced storage configuration:
 
 ```YAML
 name: DemoRegistry2