Merge pull request #218796 from shantanugg/docs-editor/deprecate-vm-1668713828

DOCS REQUEST 2398 - Amanda's request

Author: Court72

articles/marketplace/deprecate-vm.md

@@ -16,8 +16,7 @@ This article describes how to deprecate or restore virtual machine images, plans
 
 ## What is deprecation?
 
-Deprecation is the delisting of a VM offer or a subset of the offer from Azure Marketplace so that it is no longer available for customers to deploy additional instances. Reasons to deprecate may vary. Common examples are due to security issues or end of life. You can deprecate image versions, plans, or an entire VM offer:
-
+Deprecation is the removal of a VM offer or a subset of the offer from Azure Marketplace so that it is no longer available for customers to deploy additional instances. Reasons to deprecate may vary. Common examples are due to security issues or end of life. You can deprecate image versions, plans, or an entire VM offer:
 - **Deprecation of an image version** – The removal of an individual VM image version
 - **Deprecation of a plan** – The removal of a plan and subsequently all images within the plan
 - **Deprecation of an offer** – The removal of an entire VM offer, including all plans within the offer and subsequently all images within each plan
@@ -35,26 +34,23 @@ Before the scheduled deprecation date:
 
 - Customers with active deployments are notified.
 - Customers can continue to deploy new instances up until the deprecation date.
-- If deprecating an offer or plan, the offer or plan will no longer be available in the marketplace. This is to reduce the discoverability of the offer or plan.
-
+- If deprecating an offer, the offer will no longer be searchable in the marketplace upon scheduling the deprecation. This is to reduce the discoverability of the offer.
 After the scheduled deprecation date:
 
 - Customers will not be able to deploy new instances using the affected images. If deprecating a plan, all images within the plan will no longer be available and if deprecating an offer, all images within the offer will no longer be available following deprecation.
 - Active VM instances will not be impacted.
-- Existing virtual machine scale sets (VMSS) deployments cannot be scaled out if configured with any of the impacted images. If deprecating a plan or offer, all existing VMSS deployments pinned to any image within the plan or offer respectively cannot be scaled out.
-
+- Existing virtual machine scale sets deployments cannot be scaled out. If deprecating a plan or offer, all existing scale sets deployments using any image within the plan or offer respectively cannot be scaled out.
 > [!TIP]
-> Before you deprecate an offer or plan, make sure you understand the current usage by reviewing the [Usage dashboard in commercial marketplace analytics](usage-dashboard.md). If usage is high, consider hiding the plan or offer to minimize discoverability within the commercial marketplace. This will steer new customers towards other available options.
+> Before you deprecate an offer, plan, or image, make sure you understand the current usage by reviewing the [Usage dashboard in commercial marketplace analytics](https://partner.microsoft.com/dashboard/insights/commercial-marketplace/analytics/usage). If usage is high, consider hiding the plan or offer to minimize discoverability within the commercial marketplace and steer new customers towards other available options. To hide an offer, select the **Hide plan** checkbox on the **Pricing and Availability** page of each individual plan in the offer.
 
 ## Deprecate an image
 
 Keep the following things in mind when deprecating an image:
 
 - You can deprecate any image within a plan.
-- Each plan must have at least one image.
-- Publish the offer after scheduling the deprecation of an image.
-- Images that are published to preview can be deprecated or deleted immediately.
-
+- Each plan must have at least one active image.
+- You must publish the offer after scheduling the deprecation of an image.
+- Images that are published only to preview and have never been published live can be deleted immediately when the offer is still in preview state.
 **To deprecate an image**:
 
 1. On the [Marketplace offers](https://partner.microsoft.com/dashboard/marketplace-offers/overview) page, in the **Offer alias** column, select the offer with the image you want to deprecate.
@@ -69,7 +65,7 @@ Keep the following things in mind when deprecating an image:
 
 Keep the following things in mind when restoring a deprecated image:
 
-- Publish the offer after restoring an image for it to become available to customers.
+- You must publish the offer after restoring an image for it to become available to customers.
 - You can undo or cancel the deprecation anytime up until the scheduled date.
 - You can restore an image for a period of time after deprecation. After the window has expired, the image can no longer be restored.
 
@@ -82,16 +78,16 @@ Keep the following things in mind when restoring a deprecated image:
 1. In the **Action** column, select one of the following:
     - If the deprecation date shown in the **Status** column is in the future, you can select **Cancel deprecation**. The image version will then be listed under the Active tab.
     - If the deprecation date shown in the **Status** column is in the past, select **Restore image**. The image is then listed on the **Active** tab.
-    > [!NOTE]
-    > If the image can no longer be restored, then no actions will be available.
+1. > [!NOTE]
+   > If the image can no longer be restored, then no actions will be available.
+   
 1. Save your changes on the **Technical configuration** page.
 1. For the change to take effect, select **Review and publish** and publish the offer.
 
 ## Deprecate a plan
 
-Keep the following things in ming when deprecating a plan:
-
-- Publish the offer after scheduling the deprecation of a plan.
+Keep the following things in mind when deprecating a plan:
+- You must publish the offer after scheduling the deprecation of a plan.
 - Upon scheduling the deprecation of a plan, free trials are disabled immediately.
 - If a test drive is enabled on your offer and it’s configured to use the plan that’s being deprecated, be sure to reconfigure the test drive to use another plan in the offer. Otherwise, disable the test drive on the **Offer Setup** page.
 
@@ -107,8 +103,7 @@ Keep the following things in ming when deprecating a plan:
 Keep the following things in mind when restoring a plan:
 
 - Ensure that there is at least one active image version available on the **Technical Configuration** page of the plan. You can either restore a deprecated image or provide a new one.
-- Publish the offer after restoring a plan for it to become available to customers.
-
+- You must publish the offer after restoring a plan for it to become available to customers.
 **To restore a plan**:
 
 1. On the [Marketplace offers](https://partner.microsoft.com/dashboard/marketplace-offers/overview) page, in the **Offer alias** column, select the offer with the plan you want to restore.
@@ -124,17 +119,17 @@ On the **Offer Overview** page, you can deprecate the entire offer. This depreca
 
 Keep the following things in mind when deprecating an offer:
 
-- The deprecation will be scheduled 90 days into the future and customers will be notified.
+- The deprecation will immediately be scheduled 90 days into the future upon confirmation and customers will be notified
 - Test drive and any free trials will be disabled immediately upon scheduling deprecation of an offer.
 
 **To deprecate an offer**:
 
 1. On the [Marketplace offers](https://partner.microsoft.com/dashboard/marketplace-offers/overview) page, in the **Offer alias** column, select the offer you want to deprecate.
 1. On the **Offer overview** page, in the upper right, select **Deprecate offer**.
 1. In the confirmation dialog box that appears, enter the Offer ID and then confirm that you want to deprecate the offer.
-    > [!NOTE]
-    > On the [Marketplace offers](https://partner.microsoft.com/dashboard/marketplace-offers/overview) page, the **Status column** of the offer will say **Deprecation scheduled**. On the **Offer overview** page, under **Publish status**, the scheduled deprecation date is shown.
-
+1. > [!NOTE]
+   > On the **Offer overview** page, under **Publish status**, the scheduled deprecation date is shown.
+   
 ## Restore a deprecated offer
 
 You can restore an offer only if the offer contains at least one active plan and at least one active image.
@@ -147,3 +142,5 @@ You can restore an offer only if the offer contains at least one active plan and
 1. Ensure that there is at least one active image version available on the **Technical Configuration** page of the plan. Note that all deprecated images are listed under **VM Images** on the **Deprecated** tab. You can either [restore a deprecated image](#restore-a-deprecated-image) or [add a new VM image](azure-vm-plan-technical-configuration.md#vm-images). Remember, if the restore window has expired, the image can no longer be restored.
 1. Save your changes on the **Technical configuration** page.
 1. For the changes to take effect, select **Review and publish** and publish the offer.
+
+