[acr] move 'manage size' to best practices

Author: mmacy

articles/container-registry/container-registry-best-practices.md

@@ -7,7 +7,7 @@ manager: timlt
 
 ms.service: container-registry
 ms.topic: quickstart
-ms.date: 11/05/2017
+ms.date: 12/15/2017
 ms.author: marsma
 ---
 
@@ -58,6 +58,28 @@ When authenticating with an Azure container registry, there are two primary scen
 
 For in-depth information about Azure Container Registry authentication, see [Authenticate with an Azure container registry](container-registry-authentication.md).
 
+## Manage registry size
+
+The storage constraints of each [container registry SKU][container-registry-skus] are intended to align with a typical scenario: **Basic** for getting started, **Standard** for the majority of production applications, and **Premium** for hyper-scale performance and [geo-replication][container-registry-geo-replication]. Throughout the life of your registry, you should manage its size by periodically deleting unused content.
+
+You can find the current usage of a registry in the container registry **Overview** in the Azure portal:
+
+![Registry usage information in the Azure portal][registry-overview-quotas]
+
+You can manage the size of your registry by using the Azure CLI or the Azure portal.
+
+Under **SERVICES**, select **Repositories**, then right-click the repository you want to delete, then select **Delete**.
+
+![Delete a repository in the Azure portal][delete-repository-portal]
+
 ## Next steps
 
-Azure Container Registry is available in several tiers, called SKUs, that each provide different capabilities. For details on the available SKUs, see [Azure Container Registry SKUs](container-registry-skus.md).
+Azure Container Registry is available in several tiers, called SKUs, that each provide different capabilities. For details on the available SKUs, see [Azure Container Registry SKUs](container-registry-skus.md).
+
+<!-- IMAGES -->
+[delete-repository-portal]: ./media/container-registry-best-practices/delete-repository-portal.png
+[registry-overview-quotas]: ./media/container-registry-best-practices/registry-overview-quotas.png
+
+<!-- LINKS - Internal -->
+[container-registry-geo-replication]: container-registry-geo-replication.md
+[container-registry-skus]: container-registry-skus.md

articles/container-registry/container-registry-skus.md

@@ -46,26 +46,17 @@ The following table details the features and limits of the Basic, Standard, and
 
 [!INCLUDE [container-instances-limits](../../includes/container-registry-limits.md)]
 
-## Manage registry size
-The storage constraints of each SKU are intended to align with a typical scenario: Basic for getting started, Standard for the majority of production apps, and Premium for hyper-scale performance and [geo-replication][container-registry-geo-replication]. Throughout the life of your registry, you should manage its size by periodically deleting unused content.
-
-You can find the current usage of a registry in the container registry **Overview** in the Azure portal:
-
-![Registry usage information in the Azure portal][registry-overview-quotas]
-
-You can manage the size of your registry by deleting repositories in the Azure portal.
-
-Under **SERVICES**, select **Repositories**, then right-click the repository you want to delete, then select **Delete**.
-
-![Delete a repository in the Azure portal][delete-repository-portal]
-
 ## Changing SKUs
 
 You can change a registry's SKU with the Azure CLI or in the Azure portal.
 
 ### Azure CLI
 
-To move between SKUs in the Azure CLI 2.0, use the [az acr update][az-acr-update] command. For example, to switch a Basic registry to Standard
+To move between SKUs in the Azure CLI 2.0, use the [az acr update][az-acr-update] command. For example, to switch from Basic or Standard to Premium:
+
+```azurecli
+az acr update --name myregistry --resource-group myresourcegroup --sku Premium
+```
 
 ### Azure portal
 
@@ -94,8 +85,6 @@ Visit the [ACR Roadmap][acr-roadmap] on GitHub to find information about upcomin
 Submit and vote on new feature suggestions in [ACR UserVoice][container-registry-uservoice].
 
 <!-- IMAGES -->
-[delete-repository-portal]: ./media/container-registry-skus/delete-repository-portal.png
-[registry-overview-quotas]: ./media/container-registry-skus/registry-overview-quotas.png
 [update-registry-sku]: ./media/container-registry-skus/update-registry-sku.png
 
 <!-- LINKS - External -->

articles/container-registry/container-registry-upgrade.md

@@ -118,9 +118,6 @@ Once you've upgraded a Classic registry to Basic, Standard, or Premium, Azure no
 [update-classic-03-updating]: ./media/container-registry-upgrade\update-classic-03-updating.png
 [update-classic-04-updated]: ./media/container-registry-upgrade\update-classic-04-updated.png
 
-<!-- LINKS - external -->
-
-
 <!-- LINKS - internal -->
 [az-acr-update]: /cli/azure/acr#az_acr_update
 [azure-cli]: /cli/azure/install-azure-cli