Merge pull request #115571 from emuench/html

Html

Author: American-Dipper

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

@@ -6,7 +6,7 @@ ms.author: mingshen
 ms.service: marketplace
 ms.subservice: partnercenter-marketplace-publisher
 ms.topic: conceptual
-ms.date: 04/03/2020
+ms.date: 05/19/2020
 ---
 
 # Create, configure, and publish an IoT Edge module offer in Azure Marketplace
@@ -141,44 +141,15 @@ Provide a more detailed description of your offer. This can be up to 256 charact
 
 ### Description
 
-Provide a longer description of your offer, up to 3,000 characters. This is displayed to customers in the marketplace listing overview.
+[!INCLUDE [Long description-1](./includes/long-description-1.md)]
 
-Include one or more of the following in your description:
+IoT Edge module offers must include a minimum hardware requirements paragraph at the bottom of the description, such as:
 
-- The value and key benefits your offer provides
-- Category or industry associations, or both
-- In-app purchase opportunities
-- Any required disclosures
+- Minimum hardware requirements: Linux x64 and arm32 OS, 1 GB of RAM, 500 Mb of storage
 
-IoT Edge module offers must include a minimum hardware requirements paragraph at the bottom of the description. For example:
+[!INCLUDE [Long description-2](./includes/long-description-2.md)]
 
-*Minimum hardware requirements: Linux x64 and arm32 OS, 1 GB of RAM, 500 Mb of storage*
-
-Here are some tips for writing your description:
-
-- Clearly describe the value of your offer in the first few sentences of your description. Include the following items:
-    - Description of the offer.
-    - The type of user that benefits from the offer.
-    - Customer needs or issues the offer addresses.
-- Remember that the first few sentences might be displayed in search results.
-- Don't rely on features and functionality to sell your product. Instead, focus on the value your offer provides.
-- Try to use industry-specific vocabulary or benefit-based wording.
-
-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.
-
-:::image type="content" source="media/text-editor2.png" alt-text="Illustrates the rich text editor." border="false":::
-
-- To change the format of your content, highlight the text that you want to format and select a text style, as shown in this screenshot:
-
-     :::image type="content" source="media/text-editor3.png" alt-text="Illustrates the text style control in the rich text editor." border="false":::
-
-- To add a bulleted or numbered list to the text, use the options shown in this screenshot:
-  
-    :::image type="content" source="media/text-editor4.png" alt-text="Illustrates the bulleted and number list controls in the rich text editor." border="false":::
-
-- To add or remove indentation to the text, use the options shown in this screenshot:
-
-    :::image type="content" source="media/text-editor5.png" alt-text="Illustrates the indentation controls in the rich text editor." border="false":::
+[!INCLUDE [Long description-3](./includes/long-description-3.md)]
 
 #### Privacy policy URL
 

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

@@ -6,7 +6,7 @@ ms.author: mingshen
 ms.service: marketplace 
 ms.subservice: partnercenter-marketplace-publisher
 ms.topic: conceptual
-ms.date: 05/01/2020
+ms.date: 05/19/2020
 ---
 
 # Create an Azure virtual machine offer in the Azure Marketplace
@@ -192,32 +192,11 @@ Provide a longer description of your offer. This can be up to 256 characters lon
 
 #### Description
 
-Provide a detailed description of your offer, up to 3,000 characters. This is displayed to customers in the commercial marketplace listing overview.
+[!INCLUDE [Long description-1](./includes/long-description-1.md)]
 
-Include one or more of the following in your description:
+[!INCLUDE [Long description-2](./includes/long-description-2.md)]
 
-- The value and key benefits of your offer
-- Category or industry associations, or both
-- In-app purchase opportunities
-- Any required disclosures
-
-Here are some tips for writing your description:
-
-- Clearly describe the value proposition of your offer in the first few sentences of your description. Include the following items:
-  - Description of your offer.
-  - The type of user that benefits from your offer.
-  - Customer needs or issues that the offer addresses.
-- Remember that the first few sentences might be displayed in search engine results.
-- 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 apply formatting.
-
-![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) |
+[!INCLUDE [Long description-3](./includes/long-description-3.md)]
 
 #### Privacy policy link
 

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

@@ -6,7 +6,7 @@ ms.author: mingshen
 ms.service: marketplace 
 ms.subservice: partnercenter-marketplace-publisher
 ms.topic: conceptual
-ms.date: 04/07/2020
+ms.date: 05/19/2020
 ---
 
 # Create an Azure container offer
@@ -145,40 +145,11 @@ A more detailed description of your offer. This can be up to 256 characters long
 
 ### Description
 
-Provide a longer description of your offer, up to 3,000 characters. This is displayed to customers in the marketplace listing overview.
+[!INCLUDE [Long description-1](./includes/long-description-1.md)]
 
-Include one or more of the following in your description:
+[!INCLUDE [Long description-2](./includes/long-description-2.md)]
 
-- The value and key benefits your offer provides
-- Category or industry associations, or both
-- In-app purchase opportunities
-- Any required disclosures
-
-Here are some tips for writing your description:
-
-- Clearly describe the value of your offer in the first few sentences of your description. Include the following items:
-  - Description of the offer.
-  - The type of user that benefits from the offer
-  - Customer needs or issues the offer addresses.
-- Remember that the first few sentences might be displayed in search results.
-- Don't rely on features and functionality to sell your product. Instead, focus on the value your offer provides.
-- Try to use industry-specific vocabulary or benefit-based wording.
-
-To make your offer **description** more engaging, use the rich text editor, to format your description. with numbering, bullets, bold, italics, and indents to make your description more readable.
-
-:::image type="content" source="media/text-editor2.png" alt-text="Illustrates the rich text editor." border="false" :::
-
-- Use this drop-down to apply a paragraph style to text.
-
-    :::image type="content" source="media/text-editor3.png" alt-text="Illustrates the text style control in the rich text editor." border="false":::
-
-- Use these icons to apply numbering or bullets to text.
-
-     :::image type="content" source="media/text-editor4.png" alt-text="Illustrates the bulleted and number list controls in the rich text editor." border="false":::
-
-- Use these icons to add or remove indentation to or from text.
-
-    :::image type="content" source="media/text-editor5.png" alt-text="Illustrates the indentation controls in the rich text editor." border="false":::
+[!INCLUDE [Long description-3](./includes/long-description-3.md)]
 
 #### Privacy policy link
 

articles/marketplace/partner-center-portal/create-consulting-service-offer.md

@@ -6,7 +6,7 @@ ms.author: mingshen
 ms.service: marketplace 
 ms.subservice: partnercenter-marketplace-publisher
 ms.topic: conceptual
-ms.date: 05/08/2020
+ms.date: 05/19/2020
 ---
 
 # Create a consulting service offer
@@ -121,32 +121,11 @@ Provide a short description of your offer. This can be up to 100 characters long
 
 ### Description
 
-Provide a longer description of your offer, up to 3,000 characters. This is displayed to customers in the marketplace listing overview.
+[!INCLUDE [Long description-1](./includes/long-description-1.md)]
 
-Include one or more of the following in your description:
+[!INCLUDE [Long description-2](./includes/long-description-2.md)]
 
-- The value and key benefits your offer provides
-- Category or industry associations, or both
-- In-app purchase opportunities
-- Any required disclosures
-
-Here are some tips for writing your description:
-
-- Clearly describe the value of your offer in the first few sentences of your description. Include the following items:
-  - Description of the offer.
-  - The type of user that benefits from the offer.
-  - Customer needs or issues the offer addresses.
-- Remember that the first few sentences might be displayed in search results.
-- Don't rely on features and functionality to sell your product. Instead, focus on the value your offer provides.
-- Try to use industry-specific vocabulary or benefit-based wording.
-
-To make your offer description more engaging, use the rich text editor to apply formatting.
-
-![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) |
+[!INCLUDE [Long description-3](./includes/long-description-3.md)]
 
 ### Keywords
 

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

@@ -6,12 +6,12 @@ ms.author: dsindona
 ms.service: marketplace 
 ms.subservice: partnercenter-marketplace-publisher
 ms.topic: conceptual
-ms.date: 05/03/2020
+ms.date: 05/19/2020
 ---
 
 # Create an Azure application offer
 
-This article explains the steps and considerations for creating a new Azure application offer in the commercial marketplace. You should be familiar with these concepts before you create a new Azure application offer. 
+This article explains the steps and considerations for creating a new Azure application offer in the commercial marketplace. You should be familiar with these concepts before you create a new Azure application offer.
 
 Before you can publish a new Azure application offer, [create a commercial marketplace account in Partner Center](https://docs.microsoft.com/azure/marketplace/partner-center-portal/create-account) and make sure your account is enrolled in the commercial marketplace program.
 
@@ -169,26 +169,19 @@ The name you enter here will be shown to customers as the title of your offer li
 
 #### Search results summary
 
-Provide a short description of your offer (up to 100 characters), which may be used in search results.
+Provide a short description of your offer, up to 100 characters. This description may be used in search results.
 
 #### Long summary
 
-Provide a longer description of your offer (up to 256 characters). This description may be used in search results.
+Provide a longer description of your offer, up to 256 characters. This description may be used in search results.
 
 #### Description
 
-Provide a longer description of your offer (up to 3,000 characters). This description will be displayed to customers in the listing overview. Include your offer's value proposition, key benefits, category and/or industry associations, in-app purchase opportunities, and any required disclosures.
+[!INCLUDE [Long description-1](./includes/long-description-1.md)]
 
-SHere are some tips for writing your description:
+[!INCLUDE [Long description-2](./includes/long-description-2.md)]
 
-* Clearly describe the value proposition of your offer in the first few sentences of your description. Include the following items:
-  * Description of your offer.
-  * The type of user that benefits from your offer.
-  * Customer needs or issues that the offer addresses.
-* Remember that the first few sentences might be displayed in search engine results.
-* 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.
-* Consider using HTML tags to format your description to make it more engaging.
+[!INCLUDE [Rich text editor](./includes/rich-text-editor.md)]
 
 #### Search keywords
 

articles/marketplace/partner-center-portal/create-new-business-central-offer.md

@@ -132,30 +132,15 @@ The name you enter here will be shown to customers as the title of your offer li
 
 ### Short description
 
-Provide a short description of your offer (up to 100 characters), which may be used in marketplace search results.
+Provide a short description of your offer, up to 100 characters. This description may be used in marketplace search results.
 
 ### Description
 
-Provide a longer description of your offer (up to 3,000 characters). This description will be displayed to customers in the marketplace listing overview. Include your offer's value proposition, key benefits, category and/or industry associations, in-app purchase opportunities, and any required disclosures. 
+[!INCLUDE [Long description-1](./includes/long-description-1.md)]
 
-Some tips for writing your description:
+[!INCLUDE [Long description-2](./includes/long-description-2.md)]
 
-- Clearly describe your offer's value proposition in the first few sentences of your description. Include the following items in your value proposition:
-  - Description of the product
-  - The type of user that benefits from the product
-  - Customer needs or pain that the product addresses
-- Keep in mind that the first few sentences might be displayed in search engine results.  
-- Do not rely on features and functionality to sell your product. Instead, focus on the value you deliver.  
-- Use industry-specific vocabulary or benefit-based wording as much as possible.
-- Consider using HTML tags to format your description and make it more engaging.
-
-To make your offer description more engaging, use the rich text editor to apply formatting.
-
-![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) |
+[!INCLUDE [Rich text editor](./includes/rich-text-editor.md)]
 
 ### Search keywords
 

articles/marketplace/partner-center-portal/create-new-customer-engagement-offer.md

@@ -144,26 +144,11 @@ Provide a short description of your offer, up to 100 characters. This descriptio
 
 ### Description
 
-Provide a longer description of your offer, up to 3,000 characters. This description will be displayed to customers in the marketplace listing overview. Include your offer's value proposition, key benefits, category and/or industry associations, in-app purchase opportunities, and any required disclosures.
+[!INCLUDE [Long description-1](./includes/long-description-1.md)]
 
-Some tips for writing your description:
-
-- Clearly describe your offer's value proposition in the first few sentences of your description. Include the following information in your value proposition:
-  - Description of the product
-  - The type of user that benefits from the product
-  - Customer needs or pain that the product addresses
-- Keep in mind that the first few sentences might be displayed in search engine results.  
-- Do not rely on features and functionality to sell your product. Instead, focus on the value you deliver.  
-- Use industry-specific vocabulary or benefit-based wording as much as possible.
-
-To make your offer description more engaging, use the rich text editor to apply formatting.
-
-![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) |
+[!INCLUDE [Long description-2](./includes/long-description-2.md)]
 
+[!INCLUDE [Rich text editor](./includes/rich-text-editor.md)]
 
 ### Search keywords
 

articles/marketplace/partner-center-portal/create-new-managed-service-offer.md

@@ -7,7 +7,7 @@ manager: evansma
 ms.service: marketplace 
 ms.subservice: partnercenter-marketplace-publisher
 ms.topic: conceptual
-ms.date: 04/08/2020
+ms.date: 05/19/2020
 ---
 
 # Create a Managed Service offer
@@ -89,25 +89,11 @@ Provide a longer description of your offer (up to 256 characters). This long sum
 
 ### Description
 
-Provide a longer description of your offer (up to 3,000 characters). This description will be displayed to customers in the marketplace listing overview. Include your offer's value proposition, key benefits, category and/or industry associations, in-app purchase opportunities, and any required disclosures.
+[!INCLUDE [Long description-1](./includes/long-description-1.md)]
 
-Some tips for writing your description:  
+[!INCLUDE [Long description-2](./includes/long-description-2.md)]
 
-- Clearly describe your offer's value proposition in the first few sentences of your description. Include the following items in your value proposition:
-  - Description of the offer
-  - The type of user that benefits from the offer
-  - Customer needs or pain that the offer addresses
-- Keep in mind that the first few sentences might be displayed in search engine results.  
-- Do not rely on features and functionality to sell your product. Instead, focus on the value you deliver.  
-- Use industry-specific vocabulary or benefit-based wording as much as possible.
-
-To make your offer description more engaging, use the rich text editor to apply formatting.
-
-![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) |
+[!INCLUDE [Long description-3](./includes/long-description-3.md)]
 
 ### Privacy policy link