Merge pull request #6355 from MicrosoftDocs/master637479942769742404

For protected CLA branch, push strategy should use PR and merge to target branch method to work around git push error

Author: ghogen

docs/install/update-minimal-layout.md

@@ -86,6 +86,8 @@ Before creating the layout, you can find out the total size of the download and
 
 Let's walk through a few examples of how to preview, generate, and regenerate a minimal layout:
 
+::: moniker range="vs-2019"
+
 - First, here's an example of how to preview a layout for Visual Studio Enterprise versions 16.4.0 to 16.4.4 for English only.
 
     ```cmd
@@ -118,6 +120,44 @@ A couple of other examples using the **generate** command:
     MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productId Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop;includeOptional --languages en-US fr-FR
     ```
 
+::: moniker-end
+
+::: moniker range="vs-2017"
+
+- First, here's an example of how to preview a layout for Visual Studio Enterprise versions 15.0.0 to 15.9.31 for English only.
+
+    ```cmd
+    MinimalLayout.exe preview --targetLocation c:\VSLayout\ --productId Microsoft.VisualStudio.Product.Enterprise --baseVersion 15.0.0 --targetVersion 15.9.31 --languages en-US
+    ```
+
+- Here's how to generate that same layout with one workload.
+
+    ```cmd
+    MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productId Microsoft.VisualStudio.Product.Enterprise --baseVersion 15.0.0 --targetVersion 15.9.31 --add Microsoft.VisualStudio.Workload.ManagedDesktop;includeOptional --languages en-US
+    ```
+
+- And here's how to regenerate a minimal offline layout using an existing response file. 
+
+    ```cmd
+    MinimalLayout.exe regenerate -filepath c:\VSLayout\MinimalLayout.json
+    ```
+
+A couple of other examples using the **generate** command:
+
+- Here's how to add an additional workload, and include only the recommended packages. 
+
+    ```cmd
+    MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productId Microsoft.VisualStudio.Product.Professional --baseVersion 15.0.0 --targetVersion 15.9.31 --add Microsoft.VisualStudio.Workload.ManagedDesktop Microsoft.VisualStudio.Workload.NetWeb;includeRecommended --languages en-US
+    ```
+
+- And finally, here's how you'd include multiple languages in your minimal layout. 
+
+    ```cmd
+    MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productId Microsoft.VisualStudio.Product.Enterprise --baseVersion 15.0.0 --targetVersion 15.9.31 --add Microsoft.VisualStudio.Workload.ManagedDesktop;includeOptional --languages en-US fr-FR
+    ```
+
+::: moniker-end
+
 ### How to maintain a minimal layout
 
 Use the **verify** and **fix** commands to maintain your minimal layout after it's created. The **verify** command determines if there are any corrupt or missing packages in the minimal layout. If you encounter any problems after running the **verify** command, use the **fix** command to correct those missing or corrupt packages.

subscriptions/solutions/admin-solutions/includes/request-subscriptions.md

@@ -1,5 +1,5 @@
 ---
-title: Contact your admin to have a Visual Studio Subscription assigned | Microsoft Docs
+title: Contact your admin to have a Visual Studio Subscription assigned
 author: evanwindom
 ms.author: v-evwin
 manager: csbuschl
@@ -10,12 +10,12 @@ description:  Learn how to request a Visual Studio subscription at your workplac
 ---
 
 ## How to request a Visual Studio subscription from your work/school
-Many organizations, including workplaces and schools, purchase Visual Studio subscriptions through a variety of licensing programs.  These subscriptions are managed by subscriptions administrators (admins) who can assign subscriptons, establish preferences, and enable or disable certain features.  
+Many organizations, including workplaces and schools, purchase Visual Studio subscriptions through various licensing programs. These subscriptions are managed by subscriptions administrators (admins) who can assign subscriptions, establish preferences, and enable or disable certain features.  
 
-**Contact your subscription administrator to request a subscription**
-To use a subscription managed by your organization, one must first be assigned to you by an admin.  You will need to contact an admin to request a subscription.  In large organizations it may be difficult to know who your admin is.  Many organizations have multiple admins.  
+## Contact your subscription administrator to request a subscription
+To use a subscription managed by your organization, one must first be assigned to you by an admin. You will need to contact an admin to request a subscription. In large organizations, it may be difficult to know who your admin is. Many organizations have multiple admins.  
 
-If you are unsure who your admins are, you may find it helpful to contact a colleague who has a subscription assigned to them.  Existing subscribers can visit https://my.visualstudio.com/subscriptions.  They'll see a **Contact my Admin** button at the top right which they can use to send messages to admins.  The button does not expose the names or emails of the admins, though, so your colleague will need to ask an admin to contact you about your request.  
+If you're not sure who your admins are, you may find it helpful to contact a colleague who has a subscription assigned to them. Existing subscribers can visit https://my.visualstudio.com/subscriptions. They'll see a **Contact my Admin** button at the top right, which they can use to send messages to admins. The button does not expose the names or emails of the admins, though, so your colleague will need to ask an admin to contact you about your request.
 
-**Use the Contact my Admin feature**
-Please view our [Contact my Admin](https://docs.microsoft.com/visualstudio/subscriptions/contact-my-admin) article for more information about the feature. 
+## Use the Contact my Admin feature
+Read our [Contact my Admin](https://docs.microsoft.com/visualstudio/subscriptions/contact-my-admin) article for more information.

subscriptions/solutions/benefit-activation/includes/error-while-activating-azure-monthly-credit.md

@@ -1,5 +1,5 @@
 ---
-title: I'm getting an error while trying to activate my Azure monthly credit.
+title: Getting an error while trying to activate my Azure monthly credit
 description: I'm getting an error while trying to activate my Azure monthly credit included with my Visual Studio subscription.
 ms.topic: include
 ms.assetid: eed8114a-651a-47e2-bb24-130acd2a76d0

subscriptions/solutions/benefit-activation/includes/how-do-i-activate-azure-monthly-credit.md

@@ -28,6 +28,6 @@ There is no cost to use your Azure dev/test individual credit and no credit card
 Azure subscriptions created via the Visual Studio Subscriptions benefit may be impacted by restrictions that aren’t imposed on paid subscriptions. Certain geographies may not be available for creating VMs and Azure services, and certain service types may not be available. There may be a lower default quota than on paid subscriptions.  
 
 ## More information about Azure credits
-[Read more](https://docs.microsoft.com/visualstudio/subscriptions/vs-azure) information on activation, eligibility, and other support resources.  
+Read more [information on activation, eligibility, and other support resources](https://docs.microsoft.com/visualstudio/subscriptions/vs-azure).  
 
-[Learn how](https://azure.microsoft.com/pricing/member-offers/credit-for-visual-studio-subscribers/#azure-credits) to use the Azure credits that are included in your Visual Studio subscription.  
+[Learn how to use the Azure credits](https://azure.microsoft.com/pricing/member-offers/credit-for-visual-studio-subscribers/#azure-credits) that are included in your Visual Studio subscription.  

subscriptions/solutions/benefit-activation/includes/unable-to-activate-azure-devops.md

@@ -1,5 +1,5 @@
 ---
-title: I'm unable to activate my Azure DevOps benefit.
+title: Unable to activate my Azure DevOps benefit
 description: I'm unable to activate my Azure DevOps benefit included with my Visual Studio subscription.
 ms.topic: include
 ms.assetid: 3ec2a8c1-07e0-45cd-808c-c354b9e26fb4
@@ -22,4 +22,4 @@ As a Visual Studio subscriber, you can use a range of features in Azure DevOps.
 1. Sign into Azure DevOps using the email that you use to sign into your Visual Studio subscription. If you prefer to use a different email to log in, you can [create an alternate account](https://docs.microsoft.com/visualstudio/subscriptions/vs-alternate-identity) to link your subscription, allowing you to access Azure DevOps using both emails. 
 
 ## More information about subscription eligibility 
-[Read more](https://docs.microsoft.com/visualstudio/subscriptions/vs-azure-devops) information on eligibility by subscription level.
+Read more [information on eligibility by subscription level](https://docs.microsoft.com/visualstudio/subscriptions/vs-azure-devops).

subscriptions/solutions/benefit-activation/includes/unable-to-activate-azure-pay-as-you-go-subscription.md

@@ -1,5 +1,5 @@
 ---
-title: I'm unable to activate my Azure Dev / Test Pay-As-You-Go subscription.
+title: Unable to activate my Azure Dev / Test Pay-As-You-Go subscription
 description: I'm unable to activate my Azure Dev / Test Pay-As-You-Go subscription included with my Visual Studio subscription? 
 ms.topic: include
 ms.assetid: 6ad8bb6e-e571-450e-860b-acf1e78921d7
@@ -24,4 +24,4 @@ As a Visual Studio subscriber, you receive exclusive discounted hourly rates for
 
 ## More information about subscriptions
 
-[Read more information about Azure Dev/Test Pay-As-You-Go subscriptions](https://docs.microsoft.com/visualstudio/subscriptions/vs-azure-payg).
+Read more [information about Azure Dev/Test Pay-As-You-Go subscriptions](https://docs.microsoft.com/visualstudio/subscriptions/vs-azure-payg).

subscriptions/solutions/benefit-activation/includes/unable-to-activate-enterprise-mobility-security-benefit.md

@@ -1,5 +1,5 @@
 ---
-title: I'm unable to activate my Enterprise Mobility + Security (EMS) benefit.
+title: Unable to activate my Enterprise Mobility + Security (EMS) benefit
 description: I'm unable to activate my Enterprise Mobility + Security (EMS) benefit included with my Visual Studio subscription? 
 ms.topic: include
 ms.assetid: 104e6ef4-5bb1-4f26-af7c-a6925e3665c7
@@ -37,4 +37,4 @@ After you delete your Office 365 E3 subscription and create your replacement Mic
 
 ## More information about Office 365 E3 subscriptions
 
-[Read more](https://docs.microsoft.com/visualstudio/subscriptions/vs-m365) information on eligibility, how to migrate from Office 365 E3 to Microsoft 365, and FAQs.  
+Read more [information on eligibility, how to migrate from Office 365 E3 to Microsoft 365, and FAQs](https://docs.microsoft.com/visualstudio/subscriptions/vs-m365).  

subscriptions/solutions/benefit-activation/includes/unable-to-activate-pluralsight-benefit.md

@@ -1,5 +1,5 @@
 ---
-title: I'm unable to activate my Pluralsight benefit.
+title: Unable to activate my Pluralsight benefit
 description: I'm unable to activate my Pluralsight benefit included with my Visual Studio subscription? 
 ms.topic: include
 ms.assetid: 7e5d8886-538c-4e29-9c4c-8989cf4e09dd
@@ -26,4 +26,4 @@ this registration page expires after a few minutes. If you don't complete the re
 
 ## More information about the Pluralsight benefit
 
-[Read more](https://docs.microsoft.com/visualstudio/subscriptions/vs-pluralsight) information on activation, eligibility, and FAQs about the Pluralsight benefit.  
+Read more [information on activation, eligibility, and FAQs about the Pluralsight benefit](https://docs.microsoft.com/visualstudio/subscriptions/vs-pluralsight).  

subscriptions/solutions/benefit-activation/includes/unable-to-see-azure-monthly-credit-in-azure-portal.md

@@ -1,5 +1,5 @@
 ---
-title: I'm unable to see my Azure monthly credit in the Azure portal.
+title: Unable to see my Azure monthly credit in the Azure portal
 description: I'm unable to see my Azure monthly credit after logging into the Azure portal 
 ms.topic: include
 ms.assetid: 48420a4c-11b4-4bbd-a509-2c939d24e81a
@@ -41,6 +41,6 @@ Azure subscriptions created via the Visual Studio Subscriptions benefit may be i
 
 ## More information about Azure monthly credits
 
-[Read more](https://docs.microsoft.com/visualstudio/subscriptions/vs-azure) information on activation, eligibility, and other support resources.  
+Read more [information on activation, eligibility, and other support resources](https://docs.microsoft.com/visualstudio/subscriptions/vs-azure).  
 
-[Learn how](https://azure.microsoft.com/pricing/member-offers/credit-for-visual-studio-subscribers/#azure-credits) to use the Azure credits that are included in your Visual Studio subscription. 
+[Learn how to use the Azure credits](https://azure.microsoft.com/pricing/member-offers/credit-for-visual-studio-subscribers/#azure-credits) that are included in your Visual Studio subscription. 

subscriptions/solutions/downloading-activating-or-using-software/downloading-activating-or-using-software/includes/unable-to-download-software-non-visualstudio.md

@@ -1,5 +1,5 @@
 ---
-title: I'm unable to download or activate software (excluding Visual Studio family)
+title: Unable to download or activate software (excluding Visual Studio family)
 description: I'm unable to download or activate software (excluding Visual Studio family), included with my Visual Studio subscription.
 ms.topic: include
 ms.assetid: 4e67a935-40f9-4c26-b836-e06aa8582bad
@@ -29,4 +29,4 @@ You can [download an extensive list](https://download.microsoft.com/download/1/5
 You can also visit the [Product Keys](https://my.visualstudio.com/productkeys) page where all keys are available in aggregate. You can edit the notes column for identifying when and why you claimed the key. 
 
 ## More information about downloads 
-[Read more](https://docs.microsoft.com/visualstudio/subscriptions/find-keys) on finding and claiming product keys and downloads.  
+Read more on [finding and claiming product keys and downloads](https://docs.microsoft.com/visualstudio/subscriptions/find-keys).  

subscriptions/solutions/downloading-activating-or-using-software/downloading-activating-or-using-software/includes/unable-to-download-visual-studio-community.md

@@ -1,5 +1,5 @@
 ---
-title: I'm Unable to download or activate Visual Studio Community
+title: Unable to download or activate Visual Studio Community
 description: I'm unable to download or activate Visual Studio Community.
 ms.topic: include
 ms.assetid: 0c74cb35-a500-4fa0-b010-ac76ee56d2f9

subscriptions/solutions/downloading-activating-or-using-software/downloading-activating-or-using-software/includes/unable-to-locate-product.md

@@ -1,5 +1,5 @@
 ---
-title: I'm unable to locate a product
+title: Unable to locate a product
 description: I'm unable to locate a product to download with my Visual Studio subscription.
 ms.topic: include
 ms.assetid: a3635d25-8f9d-4cf8-a9c3-db41d155f989
@@ -29,4 +29,4 @@ You can [download an extensive list](https://download.microsoft.com/download/1/5
 You can also visit the [Product Keys](https://my.visualstudio.com/productkeys) page where all keys are available in aggregate. You can edit the notes column for identifying when and why you claimed the key. 
 
 ## More information about product keys
-[Read more](https://docs.microsoft.com/visualstudio/subscriptions/find-keys) on finding and claiming product keys and downloads.  
+Read more on [finding and claiming product keys and downloads](https://docs.microsoft.com/visualstudio/subscriptions/find-keys).  

subscriptions/solutions/downloading-activating-or-using-software/finding-or-using-product-keys/includes/unable-to-find-or-claim-product-keys.md

@@ -24,4 +24,4 @@ If you don’t see a key or product, it’s possible that the product is not ava
 
 ## More information on product key types
 
-[Read more](https://docs.microsoft.com/visualstudio/subscriptions/find-keys) about product key types and claiming product keys.  
+Read more about [product key types and claiming product keys](https://docs.microsoft.com/visualstudio/subscriptions/find-keys).  

subscriptions/solutions/other-or-no-solution/includes/no-solution.md

@@ -1,6 +1,6 @@
 ---
-title: Other 
-description: Solution shown when 'other' category is selected or no solution is found
+title: My issue is not listed 
+description: Solution shown when 'issue not listed' category is selected or no solution is found
 ms.topic: include
 ms.assetid: c1537b27-0ae4-4bf3-b1e4-ff05f8e14359
 author: caitybuschlen

subscriptions/solutions/portal-issue/includes/controls-or-buttons-not-working.md

@@ -1,5 +1,5 @@
 ---
-title: Controls or buttons are not working.
+title: Controls or buttons are not working
 description: Controls or buttons are not working in the Visual Studio subscription portal.
 ms.topic: include
 ms.assetid: 33b1aa45-b2fc-4c00-9862-3d1281d28fa2

subscriptions/solutions/portal-issue/includes/page-cannot-be-displayed.md

@@ -1,5 +1,5 @@
 ---
-title: Page cannot be displayed.
+title: Page cannot be displayed
 description: Page cannot be displayed in the Visual Studio subscription portal.
 ms.topic: include
 ms.assetid: aef07dc7-29cc-406e-9373-0b808facb35b

subscriptions/solutions/renewing-purchasing-or-canceling/help-purchasing/includes/help-me-purchase-marketplace.md

@@ -23,7 +23,7 @@ Billing is handled through your Microsoft Azure subscription. If you don’t hav
 * [Visual Studio Professional - monthly subscription](https://marketplace.visualstudio.com/items?itemName=ms.vs-professional-monthly) 
 * [Visual Studio Enterprise - monthly subscription](https://marketplace.visualstudio.com/items?itemName=ms.vs-enterprise-monthly) 
 
-[Read more](https://docs.microsoft.com/visualstudio/subscriptions/vscloud-billing-faq) about monthly Visual Studio Subscriptions Azure billing. 
+Read more about [monthly Visual Studio Subscriptions Azure billing](https://docs.microsoft.com/visualstudio/subscriptions/vscloud-billing-faq). 
 
 ## More information about subscription benefits
 

subscriptions/solutions/renewing-purchasing-or-canceling/help-purchasing/includes/where-can-i-purchase-from.md

@@ -37,8 +37,8 @@ With monthly subscriptions, you can rent Visual Studio and Azure DevOps without
 * [Visual Studio Professional - monthly subscription](https://marketplace.visualstudio.com/items?itemName=ms.vs-professional-monthly) 
 * [Visual Studio Enterprise - monthly subscription](https://marketplace.visualstudio.com/items?itemName=ms.vs-enterprise-monthly) 
 
-[Read more](https://docs.microsoft.com/visualstudio/subscriptions/vscloud-billing-faq) about monthly Visual Studio Subscriptions billing. 
+Read more about [monthly Visual Studio Subscriptions billing](https://docs.microsoft.com/visualstudio/subscriptions/vscloud-billing-faq). 
 
 ## Volume Licensing 
 
-Volume Licensing subscriptions are available when an organization needs to purchase a large number of subscriptions. [Read more](https://www.microsoft.com/licensing/how-to-buy/how-to-buy) about purchasing through Volume Licensing.
+Volume Licensing subscriptions are available when an organization needs to purchase a large number of subscriptions. Read more about [purchasing through Volume Licensing](https://www.microsoft.com/licensing/how-to-buy/how-to-buy).

subscriptions/solutions/renewing-purchasing-or-canceling/help-renewing/includes/help-me-renew-marketplace.md

@@ -14,6 +14,6 @@ sap.id: b324c31f-5d44-4cc2-537a-9c354bc5fbfc
 
 ## Renewing subscriptions through Visual Studio Marketplace 
 
-As long as your payment method is still valid, your Visual Studio subscriptions through Marketplace are auto renewed. [Read more](https://docs.microsoft.com/visualstudio/subscriptions/vscloud-billing-faq) about Visual Studio Subscriptions Azure billing. 
+As long as your payment method is still valid, your Visual Studio subscriptions through Marketplace are auto renewed. Read more about [Visual Studio Subscriptions Azure billing](https://docs.microsoft.com/visualstudio/subscriptions/vscloud-billing-faq). 
 
 If you do not wish to renew a subscription, reduce your number of paid users in [Visual Studio Marketplace](https://marketplace.visualstudio.com/subscriptions). The new monthly billing amount and reduced users will take effect on the 1st of the next month. 

subscriptions/solutions/renewing-purchasing-or-canceling/help-renewing/includes/help-me-renew-microsoft-store.md

@@ -1,5 +1,5 @@
 ---
-title: Help me renew my through the Microsoft store.
+title: Help me renew my through the Microsoft store
 description: Help me renew my Visual Studio subscriptions purchased from the Microsoft store.
 ms.topic: include
 ms.assetid: 3b36270b-aa3b-4c05-b12e-4df8d6f823c1

subscriptions/solutions/signing-in/includes/how-do-i-change-my-sign-in-email-cloud-self.md

@@ -22,5 +22,4 @@ If you purchased one or more cloud subscriptions for yourself, you were set up a
 0. Change the email address as desired.
 0. Click **Save**.
 
-> [!NOTE]
-> This does not change the email address you use to sign in to the Administration Portal.
+Note: This does not change the email address you use to sign in to the Administration Portal.