Merge pull request #113253 from emuench/create

Updates for consistent text and formatting across topics

Author: American-Dipper

articles/marketplace/partner-center-portal/azure-iot-edge-module-creation.md

@@ -14,18 +14,15 @@ ms.date: 04/03/2020
 > [!IMPORTANT]
 > We're moving the management of your IoT Edge module offers from Cloud Partner Portal to Partner Center. Until your offers are migrated, please follow the instructions in [IoT Edge module offer publishing overview](https://docs.microsoft.com/azure/marketplace/cloud-partner-portal/iot-edge-module/cpp-offer-process-parts) for Cloud Partner Portal to manage your offers.
 
-This article describes how to create and publish an Internet of Things (IoT) Edge module offer for Azure Marketplace.
-
-Before you can create an IoT Edge module offer, you must have a commercial marketplace account in Partner Center. If you haven't created one yet, see [Create a commercial marketplace account in Partner Center](https://docs.microsoft.com/azure/marketplace/partner-center-portal/create-account).
+This article describes how to create and publish an Internet of Things (IoT) Edge module offer for Azure Marketplace. Before starting, [Create a Commercial Marketplace account in Partner Center](https://docs.microsoft.com/azure/marketplace/partner-center-portal/create-account) if you haven't done so yet. Ensure your account is enrolled in the commercial marketplace program.
 
 ## Create a new offer
 
-1. Sign in to Partner Center.
-2. In the left-navigation menu, select **Commercial Marketplace** > **Overview**.
-
-    ![Illustrates the left-navigation menu.](./media/cs-menu-overview.png)
+1. Sign in to [Partner Center](https://partner.microsoft.com/dashboard/home).
+2. In the left-nav menu, select **Commercial Marketplace** > **Overview**.
+3. On the Overview page, select **+ New offer** > **IoT Edge module**.
 
-3. Select **+ New offer** > **IoT Edge module**. The **New offer** dialog box appears.
+    ![Illustrates the left-navigation menu.](./media/new-offer-iot-edge.png)
 
 > [!IMPORTANT]
 > After an offer is published, edits made to it in Partner Center only appear in storefronts after republishing the offer. Make sure you always republish after making changes.
@@ -36,14 +33,14 @@ Enter an **Offer ID**. This is a unique identifier for each offer in your accoun
 
 - This ID is visible to customers in the web address for the marketplace offer and Azure Resource Manager templates, if applicable.
 - Use only lowercase letters and numbers. It can include hyphens and underscores, but no spaces, and is limited to 50 characters. For example, if you enter **test-offer-1**, the offer web address will be `https://azuremarketplace.microsoft.com/marketplace/../test-offer-1`.
-- The Offer ID can't be changed after you select Create.
+- The Offer ID can't be changed after you select **Create**.
 
-Enter an **Offer alias**. This is the name used to refer to the offer in Partner Center.
+Enter an **Offer alias**. This is the name used for the offer in Partner Center.
 
 - This name isn't used in the marketplace and is different from the offer name and other values shown to customers.
 - This can't be changed after you select **Create**.
 
-After you enter these two values, select **Create** before continuing to the next page, Offer overview.
+Select **Create** to generate the offer and continue.
 
 ## Offer overview
 
@@ -84,7 +81,7 @@ Here are some additional lead management resources:
 - [Common lead configuration errors](https://docs.microsoft.com/azure/marketplace/lead-management-for-cloud-marketplace#common-lead-configuration-errors-during-publishing-on-cloud-partner-portal)
 - [Lead Management Overview](https://assetsprod.microsoft.com/mpn/cloud-marketplace-lead-management.pdf) PDF (Make sure your pop-up blocker is turned off).
 
-Select **Save draft** before continuing to the next section, Properties.
+Select **Save draft** before continuing.
 
 ### Properties
 

articles/marketplace/partner-center-portal/azure-vm-create-offer.md

@@ -6,15 +6,15 @@ ms.author: mingshen
 ms.service: marketplace 
 ms.subservice: partnercenter-marketplace-publisher
 ms.topic: conceptual
-ms.date: 04/10/2020
+ms.date: 05/01/2020
 ---
 
 # Create an Azure virtual machine offer
 
 > [!IMPORTANT]
 > We're moving the management of your Azure VM offers from Cloud Partner Portal to Partner Center. Until your offers are migrated, please continue to follow the instructions in [Create Virtual Machine offer](https://docs.microsoft.com/azure/marketplace/cloud-partner-portal/virtual-machine/cpp-create-offer) in Cloud Partner Portal to manage your offers.
 
-This article describes how to create and publish an Azure virtual machine offer to [Azure Marketplace](https://azuremarketplace.microsoft.com/). It addresses both Windows- and Linux-based virtual machines that contain an operating system, virtual hard disk (VHD), and up to 16 data disks.
+This article describes how to create and publish an Azure virtual machine offer to [Azure Marketplace](https://azuremarketplace.microsoft.com/). It addresses both Windows- and Linux-based virtual machines that contain an operating system, virtual hard disk (VHD), and up to 16 data disks. Before starting, [Create a Commercial Marketplace account in Partner Center](https://docs.microsoft.com/azure/marketplace/partner-center-portal/create-account) if you haven't done so yet. Ensure your account is enrolled in the commercial marketplace program.
 
 ## Introduction
 
@@ -53,41 +53,44 @@ Your engineering team should understand the following Microsoft technologies:
 - How to [design and architect Azure applications](https://azure.microsoft.com/solutions/architecture/)
 - Working knowledge of [Azure Virtual Machines](https://azure.microsoft.com/services/virtual-machines/), [Azure Storage](https://azure.microsoft.com/services/?filter=storage#storage), and [Azure Networking](https://azure.microsoft.com/services/?filter=networking#networking)
 
-## Create an Azure virtual machine offer
+## Create a new offer
 
-Before you can create an Azure virtual machine offer, you must have a commercial marketplace account in Partner Center. If you haven't created one yet, see [Create a commercial marketplace account in Partner Center](https://docs.microsoft.com/azure/marketplace/partner-center-portal/create-account).
+1. Sign in to [Partner Center](https://partner.microsoft.com/dashboard/home).
+2. In the left-nav menu, select **Commercial Marketplace** > **Overview**.
+3. On the Overview page, select **+ New offer** > **Azure Virtual Machine**.
 
-1. Sign in to [Partner Center](https://partner.microsoft.com/dashboard/home), and then from the top menu, select **Dashboard**.
-2. In the left-nav bar, select **Commercial Marketplace**, then **Overview**.
-3. On the **Overview** page, select **+ New offer**, then **Azure Virtual Machine**. The **New offer** dialog box appears.
+    ![Illustrates the left-navigation menu.](./media/new-offer-azure-vm.png)
 
-    ![Illustrates the Overview page in Partner Center with the New offer button and Azure Virtual Machine offer selected.](media/avm-create7.png)
+> [!NOTE]
+> After an offer is published, edits made to it in Partner Center only appear in storefronts after republishing the offer. Make sure you always republish after making changes.
 
-## Offer ID and alias
+## New offer
 
 Enter an **Offer ID**. This is a unique identifier for each offer in your account.
 
 - This ID is visible to customers in the web address for the marketplace offer and in Azure PowerShell and Azure CLI, if applicable.
 - Use only lowercase letters and numbers. It can include hyphens and underscores, but no spaces, and is limited to 50 characters. For example, if you enter **test-offer-1** here, the offer web address will be `https://azuremarketplace.microsoft.com/marketplace/../test-offer-1`.
 - The Offer ID can't be changed after you select **Create**.
 
-Enter an **Offer alias**. This is the name used for the offer in Partner Center. This name isn't used in the marketplace and is different from the offer name and other values shown to customers.
+Enter an **Offer alias**. This is the name used for the offer in Partner Center.
+
+- This name isn't used in the marketplace and is different from the offer name and other values shown to customers.
 
 Select **Create** to generate the offer and continue.
 
 ## Offer setup
 
 ### Test drive
 
-Set up a demonstration (test drive) that lets customers try your offer before purchasing it. To create a demonstration environment that lets customers try your offer for a fixed period of time, see [Test Drive your offer in the commercial marketplace](https://docs.microsoft.com/azure/marketplace/partner-center-portal/test-drive).
+A test drive is a great way to showcase your offer to potential customers by giving them the option to "try before you buy", resulting in increased conversion and the generation of highly qualified leads. [Learn more about test drives](https://docs.microsoft.com/azure/marketplace/cloud-partner-portal/test-drive/what-is-test-drive).
 
-To enable a test drive, select the **Enable a test drive** check box. To remove test drive from your offer, clear this check box.
+To enable a test drive for a fixed period of time, select the **Enable a test drive** check box. To remove test drive from your offer, clear this check box.
 
 Additional test drive resources:
 
 - [Technical best practices](https://github.com/Azure/AzureTestDrive/wiki/Test-Drive-Best-Practices)
 - [Marketing best practices](https://docs.microsoft.com/azure/marketplace/cloud-partner-portal/test-drive/marketing-and-best-practices)
-- [Test Drives overview](https://assetsprod.microsoft.com/mpn/azure-marketplace-appsource-test-drives.pdf) PDF (make sure your pop-up blocker is off).
+- [Test drives overview](https://assetsprod.microsoft.com/mpn/azure-marketplace-appsource-test-drives.pdf) PDF (make sure your pop-up blocker is off)
 
 ### Lead management
 
@@ -208,9 +211,13 @@ Here are some tips for writing your description:
 - Don't rely on features and functionality to sell your offer. Instead, focus on the value your offer provides.
 - Use industry-specific or benefit-based words.
 
-To make your offer description more engaging, use the rich text editor to format your description. The rich text editor lets you add numbers, bullets, bold, italics, and indents to make your description more readable.
+To make your offer description more engaging, use the rich text editor to apply formatting.
 
-![Illustrates the Overview page in Partner Center with the New offer button and Consulting service offer selected.](media/power-bi-rich-text-editor.png)
+![Using the rich text editor](./media/rich-text-editor.png)
+
+| <center>Change text format | <center>Add bullets or numbering | <center>Add or remove text indent |
+| --- | --- | --- |
+| <center>![Using the rich text editor to change text format](./media/text-editor3.png) |  <center>![Using the rich text editor to add lists](./media/text-editor4.png) |  <center>![Using the rich text editor to indent](./media/text-editor5.png) |
 
 #### Privacy policy link
 
@@ -251,7 +258,7 @@ Provide contact information for Microsoft to use when there are issues with your
 Provide logos and images to use with your offer. All images must be in PNG format. Blurry images will cause your submission to be rejected.
 
 >[!Note]
->If you have an issue uploading files, make sure your local network does not block the https://upload.xboxlive.com service used by Partner Center.
+>If you have an issue uploading files, ensure your local network does not block the https://upload.xboxlive.com service used by Partner Center.
 
 #### Marketplace logos
 
@@ -266,11 +273,11 @@ All four logos are required and are used in different places in the marketplace
 
 #### Screenshots
 
-Add up to five screenshots that show how your offer works. Each screenshot must be 1280 x 720 pixels in size and in PNG format. You must also add a caption to describe your screenshot.
+Add up to five screenshots that show how your offer works. Each screenshot must be 1280 x 720 pixels in size and in PNG format. Each screenshot must include a caption.
 
 #### Videos
 
-Add up to five videos that demonstrate your offer. These should be hosted on an external video service. Enter each video's name, web address, and a thumbnail PNG image of the video at 1280 x 720 pixels in size.
+Add up to five videos that demonstrate your offer. These should be hosted on an external video service. Enter each video's name, web address, and a thumbnail PNG image of the video at 1280 x 720 pixels.
 
 For additional marketplace listing resources, see [Best practices for marketplace offer listings](https://docs.microsoft.com/azure/marketplace/gtm-offer-listing-best-practices).
 
@@ -326,7 +333,7 @@ Select **Create**.
 
 Set the high-level configuration for the type of plan, whether it reuses technical configuration from another plan, and in which Azure regions the plan should be available. Your selections here determine which fields are displayed on other tabs for the same plan.
 
-#### Reuse technical configuration
+#### Re-use technical configuration
 
 If you have more than one plan of the same type, and the packages are identical between them, you can select **this plan reuses technical configuration from another plan**. This option lets you select one of the other plans of the same type for this offer and reuse its technical configuration.
 
@@ -337,7 +344,7 @@ If you have more than one plan of the same type, and the packages are identical
 
 Your plan must be made available in at least one Azure region.
 
-Select the **Azure Global** option to make your plan available to customers in all public Azure regions that have commercial marketplace integration. For details, see [Geographic availability and currency support](https://docs.microsoft.com/azure/marketplace/marketplace-geo-availability-currencies).
+Select the **Azure Global** option to make your plan available to customers in all Azure Global regions that have commercial marketplace integration. For details, see [Geographic availability and currency support](https://docs.microsoft.com/azure/marketplace/marketplace-geo-availability-currencies).
 
 Select the **Azure Government** option to make your plan available in the [Azure Government](https://docs.microsoft.com/azure/azure-government/documentation-government-welcome) region. This region provides controlled access for customers from  U.S. federal, state, local, or tribal entities, as well as partners eligible to serve them. You, as the publisher, are responsible for any compliance controls, security measures, and best practices. Azure Government uses physically isolated data centers and networks (located in the U.S. only).
 
@@ -348,15 +355,15 @@ Before publishing to [Azure Government](https://docs.microsoft.com/azure/azure-g
 
 #### Azure Government certifications
 
-This option is only visible if you select **Azure Government** under **Azure regions**.
+This option is only visible if you selected **Azure Government**.
 
 Azure Government services handle data that is subject to certain government regulations and requirements. For example, FedRAMP, NIST 800.171 (DIB), ITAR, IRS 1075, DoD L4, and CJIS. To bring awareness to your certifications for these programs, you can provide up to 100 links that describe them. These can be either links to your listing on the program directly or links to descriptions of your compliance with them on your own websites. These links visible to Azure Government customers only.
 
 Select **Save draft** before continuing.
 
 ### Plan listing
 
-This is where you configure listing detail of the plan. This tab displays specific information that can differ between plans in the same offer.
+This is where you configure listing details of the plan. This tab displays specific information that can differ between plans in the same offer.
 
 #### Plan name
 
@@ -483,9 +490,9 @@ To enable a test drive, select the Enable a test drive check box on the [Offer s
 
 Additional test drive resources:
 
-- Technical best practices
-- Marketing best practices
-- Test Drives overview (PDF; make sure your pop-up blocker is off).
+- [Marketing best practices](https://docs.microsoft.com/azure/marketplace/cloud-partner-portal/test-drive/marketing-and-best-practices)
+- [Technical best practices](https://github.com/Azure/AzureTestDrive/wiki/Test-Drive-Best-Practices)
+- [Overview](https://assetsprod.microsoft.com/mpn/azure-marketplace-appsource-test-drives.pdf) (PDF; make sure your pop-up blocker is off)
 
 Select **Save draft** before continuing.
 

articles/marketplace/partner-center-portal/create-azure-container-offer.md

@@ -14,15 +14,15 @@ ms.date: 04/07/2020
 > [!IMPORTANT]
 > We're moving the management of your Azure Container offers from Cloud Partner Portal to Partner Center. Until your offers are migrated, please follow the instructions in [Containers](https://docs.microsoft.com/azure/marketplace/cloud-partner-portal/containers/cpp-containers-offer) for Cloud Partner Portal to manage your offers.
 
-This article describes how to create and publish a Container offer for Azure Marketplace. Before starting, [Create a Commercial Marketplace account in Partner Center](https://docs.microsoft.com/azure/marketplace/partner-center-portal/create-account).
+This article describes how to create and publish a Container offer for Azure Marketplace. Before starting, [Create a Commercial Marketplace account in Partner Center](https://docs.microsoft.com/azure/marketplace/partner-center-portal/create-account) if you haven't done so yet. Ensure your account is enrolled in the commercial marketplace program.
 
 ## Create a new offer
 
-1. Log in to [Partner Center](https://partner.microsoft.com/dashboard/home), and then from the top menu, select **Dashboard**.
-2. In the left menu, select **Commercial Marketplace**, then **Overview**.
-3. On the **Overview** page, select **+ New offer**, then **Azure Container**. The **New offer** dialog box appears.
+1. Sign in to [Partner Center](https://partner.microsoft.com/dashboard/home).
+2. In the left-nav menu, select **Commercial Marketplace** > **Overview**.
+3. On the Overview page, select **+ New offer** > **Azure Container**.
 
-:::image type="content" source="media/azure-create-container-offer-images/azure-create-new-container.png" alt-text="Illustrated the Overview page in Partner Center. The New offer button and Consulting service offer are highlighted.":::
+    ![Illustrates the left-navigation menu.](./media/new-offer-azure-container.png)
 
 > [!TIP]
 > After an offer is published, edits made to it in Partner Center only appear in storefronts after republishing the offer. Make sure you always republish after making changes.
@@ -31,16 +31,16 @@ This article describes how to create and publish a Container offer for Azure Mar
 
 Enter an **Offer ID**. This is a unique identifier for each offer in your account.
 
-- This ID can be seen by customers in the web address for the marketplace offer and Azure Resource Manager templates, if applicable.
+- This ID is visible to customers in the web address for the marketplace offer and Azure Resource Manager templates, if applicable.
 - Use only lowercase letters and numbers. It can include hyphens and underscores, but no spaces, and is limited to 50 characters. For example, if you enter **test-offer-1**, the offer web address will be `https://azuremarketplace.microsoft.com/marketplace/../test-offer-1`.
 - The Offer ID can't be changed after you select **Create**.
 
-**Enter an** **Offer alias**. This is the name used to refer to the offer in Partner Center.
+Enter an **Offer alias**. This is the name used for the offer in Partner Center.
 
 - This name isn't used in the marketplace and is different from the offer name and other values shown to customers.
 - This can't be changed after you select **Create**.
 
-Select **Create** before continuing.
+Select **Create** to generate the offer and continue.
 
 ## Offer overview
 
@@ -82,7 +82,7 @@ Here are some additional lead management resources:
 - [Common lead configuration errors](https://docs.microsoft.com/azure/marketplace/lead-management-for-cloud-marketplace#common-lead-configuration-errors-during-publishing-on-cloud-partner-portal)
 - [Lead Management Overview](https://assetsprod.microsoft.com/mpn/cloud-marketplace-lead-management.pdf) PDF (Make sure your pop-up blocker is turned off)
 
-Select **Save draft** before continuing to the next section, Properties.
+Select **Save draft** before continuing.
 
 ### Properties