Merging changes synced from https://github.com/MicrosoftDocs/visualstudio-docs-pr (branch live)

Author: ghogen

docs/install/visual-studio-enterprise-guide.md

@@ -0,0 +1,69 @@
+---
+title: Visual Studio enterprise guide
+description: Set up and troubleshoot Visual Studio in an enterprise environment.
+ms.date: 07/29/2020
+ms.custom: seodec18
+ms.topic: overview
+helpviewer_keywords:
+- network installation, Visual Studio
+- administrator guide, Visual Studio
+- installing Visual Studio, administrator guide
+ms.assetid: 
+author: ornellaalt
+ms.author: ornella
+manager: jillfra
+ms.workload:
+- multiple
+ms.prod: visual-studio-windows
+ms.technology: vs-installation
+---
+# Visual Studio enterprise guide
+If you’re looking to save time while you're getting your company running on Visual Studio, start here. This enterprise guide includes tips that can help you install and update Visual Studio in common enterprise scenarios, get unblocked if you experience issues, and learn how to report a problem if you need more help. 
+
+## Get started 
+Learn how to deploy Visual Studio to your enterprise in networked and offline environments. 
+
+- **Understand options for enterprise deployment in networked environments**. The [Visual Studio administrator guide](visual-studio-administrator-guide.md) provides scenario-based guidance for system administrators. 
+
+- **[Get troubleshooting tips](troubleshooting-installation-issues.md)**. Get help when you’re installing or updating Visual Studio, and learn how to report a problem if you’re blocked. These tips include step-by-step instructions that should resolve most online or offline installation issues. 
+
+- **[Create an offline installation of Visual Studio](create-an-offline-installation-of-visual-studio.md)**. If you’re not connected to the Internet or have limited Internet connectivity, find options for installing Visual Studio. 
+
+- **[Create bootstrapper packages](../deployment/creating-bootstrapper-packages.md)**. Learn how to create custom bootstrapper packages by creating product and package manifests. 
+
+- **[Automatically apply product keys when deploying Visual Studio](automatically-apply-product-keys-when-deploying-visual-studio.md)**. You can apply your product key programmatically as part of a script that is used to automate the deployment of Visual Studio. You can set a product key on a device programmatically, either during an installation of Visual Studio, or after an installation completes. 
+
+## Install Visual Studio 
+
+Learn how to install Visual Studio in common enterprise scenarios. 
+
+- **[Use command-line parameters to install Visual Studio](use-command-line-parameters-to-install-visual-studio.md)**. Use a variety of parameters to control or customize your Visual Studio installation. Automate the installation process or create a cache of the installation files for later use. 
+
+- **See [command-line parameter examples for Visual Studio installation](command-line-parameter-examples.md)**. To illustrate how to use command-line parameters to install Visual Studio, view several examples that you can customize to match your needs. 
+
+- **[Install and use Visual Studio and Azure Services behind a firewall or proxy server](install-and-use-visual-studio-behind-a-firewall-or-proxy-server.md)**. If your organization uses security measures such as a firewall or a proxy server, then there are domain URLs that you might want to add to an "allow list" and ports and protocols that you might want to open so that you have the best experience when you install and use Visual Studio and Azure Services. 
+
+- **[Create a network installation of Visual Studio](create-a-network-installation-of-visual-studio.md)**. Cache the files for the initial installation along with all product updates to a single folder.  
+
+## Update Visual Studio 
+
+Learn how to update Visual Studio successfully and fix update issues. 
+
+- **[Update a network-based installation of Visual Studio](update-a-network-installation-of-visual-studio.md)**. Update a network installation layout of Visual Studio with the latest product updates so that it can be used both as an installation point for the latest update of Visual Studio and also to maintain installations that are already deployed to client workstations.
+
+- **[Update Visual Studio while on a servicing baseline](update-servicing-baseline.md)**. Understand the value in updating on a baseline and learn the difference between minor releases and servicing updates. 
+
+- **[Update Visual Studio using a minimal offline layout](update-minimal-layout.md)**. For computers that are not connected to the internet, creating a minimal layout is the easiest and fastest way to update your offline Visual Studio instances.
+
+- **[Repair Visual Studio](repair-visual-studio.md) to fix update issues**. Sometimes your Visual Studio installation becomes damaged or corrupted. A repair is useful for fixing install-time issues across all install operations, including updates. 
+
+- **Follow [Windows security baselines](https://docs.microsoft.com/windows/security/threat-protection/windows-security-baselines)**. Microsoft is dedicated to providing its customers with secure operating systems, such as Windows 10 and Windows Server, and secure apps, such as Microsoft Edge. In addition to the security assurance of its products, Microsoft also enables you to have fine control over your environments by providing various configuration capabilities. 
+
+[!INCLUDE[install_get_support_md](includes/install_get_support_md.md)]
+
+## See also 
+
+- [Productivity guide for Visual Studio](../ide/productivity-features.md)
+
+
+

docs/toc.yml

@@ -42,6 +42,8 @@
     items:
     - name: Overview
       href: install/visual-studio-administrator-guide.md
+    - name: Visual Studio enterprise guide
+      href: install/visual-studio-enterprise-guide.md
     - name: Use the command line
       items:
       - name: Use command-line parameters to install Visual Studio

subscriptions/cloud-admin.md

@@ -30,19 +30,19 @@ To add administrators:
 2. Sign in with the account you used to purchase the Visual Studio monthly subscriptions.
 3. Under **Azure services**, choose **Cost Management + Billing**.
    > [!div class="mx-imgBorder"]
-   > ![Choose Cost Management + Billing under Azure services](_img/cloud-admin/azure-cost-billing.png)
+   > ![Choose Cost Management + Billing under Azure services](_img/cloud-admin/azure-cost-billing.png "Choose Cost Management from the Azure services group")
 4. In the **My subscriptions** list, choose the Azure subscription that you used to make the purchase.
    > [!div class="mx-imgBorder"]
-   > ![Choose subscription](_img/cloud-admin/subscription-list.png)
+   > ![Choose subscription](_img/cloud-admin/subscription-list.png "Choose the Azure subscription you wish to use to make your purchase.")
 5. Click **Access control (IAM)**, which is located near the top of the list in the left navigation pane.
 6. Click the **Add** tab at the top of the page.
 7. Click **Add role assignment**.
    > [!div class="mx-imgBorder"]
-   > ![Choose Access control, Add, Add role assignment](_img/cloud-admin/access-control-add.png)
+   > ![Choose Access control, Add, Add role assignment](_img/cloud-admin/access-control-add.png "Choose Access control from the list on the left, then choose Add.")
 8. In the fly-out pane on the right, click on the **Role** drop-down at the top of the pane, scroll down, and select **User Access Administrator**.
 9. In the list of users, scroll down to the user you wish to make an admin, and select them. 
    > [!div class="mx-imgBorder"]
-   > ![Choose Role, User access admin](_img/cloud-admin/add-role-user-access-admin.png)
+   > ![Choose Role, User access admin](_img/cloud-admin/add-role-user-access-admin.png "Choose Role, select User Access Administrator, then select the name of the user to make them an admin.")
 10. Click **Save**.
 11. Click on the **Role assignments** tab to verify that the user you selected now appears as a User Access Administrator.
 

subscriptions/contact-my-admin.md

@@ -19,7 +19,7 @@ Given the size and complexity of many organizations, you may not be aware of who
 2. Click on the **Subscriptions** tab. 
 3. Click the **Contact my Admin** button at the top right. 
    > [!div class="mx-imgBorder"]
-   > ![Contact my Admin](_img/contact-my-admin/contact-my-admin-button.png)
+   > ![Contact my Admin](_img/contact-my-admin/contact-my-admin-button.png "Click the Contact my Admin button, enter your message, and click Send.")
 4. Enter the message for your admin.
 5. If you'd like to receive a copy of the message sent to your admin, click the **Send me a copy** checkbox. 
 6. Finally, click **Send**.

subscriptions/delete-license.md

@@ -19,7 +19,7 @@ When a subscriber no longer requires a Visual Studio subscription, such as when
 2. To delete the selected subscriber(s), click **Delete**.
 3. When the message appears asking you to confirm the deletion, click **OK**.
    > [!div class="mx-imgBorder"]
-   > ![Delete subscribers](_img/delete-license/delete-subscribers.png)
+   > ![Delete subscribers](_img/delete-license/delete-subscribers.png "Choose the user(s) you wish to delete, and click Delete. You can use CTRL and Shift keys to select multiple subscribers.")
 
    > [!NOTE]
    > Bulk delete using a template is not available. For organizations that manage subscription assignments through Azure Active Directory Security Groups, see [our article](assign-license-bulk.md#use-azure-active-directory-groups-to-assign-subscriptions) for more information about how deletions happen.  

subscriptions/download-software.md

@@ -2,9 +2,9 @@
 title: Downloading software titles in Visual Studio subscriptions | Microsoft Docs
 author: evanwindom
 ms.author: lank
-manager: lank
+manager: cabuschl
 ms.assetid: e2f2619c-7736-47e5-a066-5940d5994db9
-ms.date: 03/07/2020
+ms.date: 07/29/2020
 ms.topic: conceptual
 description:  Learn how to locate and download Microsoft software titles in Visual Studio subscriptions
 ---
@@ -22,11 +22,11 @@ If your subscription is provided by your work or school, your subscriptions admi
 ## How do I find downloads in the subscriber portal?
 When you visit the [Downloads](https://my.visualstudio.com/downloads/featured?wt.mc_id=o~msft~docs) page, you'll see popular downloads arranged in groups by product type.  You can select one of the popular downloads shown, or search for any product using the search bar at the top of the page.
 > [!div class="mx-imgBorder"]
-> ![Subscriber downloads page](_img/subscriber-downloads/subscriber-downloads-resized.png)
+> ![Subscriber downloads page](_img/subscriber-downloads/subscriber-downloads-resized.png "The most popular downloads are displayed when you click on the Downloads blade.")
 
 For example, if you choose **Visual Studio 2019** from the Developer Tools list, you'll see a list of available Visual Studio 2019 downloads.
 > [!div class="mx-imgBorder"]
-> ![Visual Studio 2019 downloads](_img/subscriber-downloads/vs2019-product-list.png)
+> ![Visual Studio 2019 downloads](_img/subscriber-downloads/vs2019-product-list.png "When you select a product, a list of available versions is displayed.")
 
 You easily select your architecture, language and file type using the available drop-down menus. Choose your preferred options, and click **Download** to begin downloading the product.
 
@@ -36,16 +36,16 @@ You easily select your architecture, language and file type using the available
 ### Displaying download details
 Clicking on the product name or on the **Info** link will display the details for that download and provide access to the release notes for the product.
 > [!div class="mx-imgBorder"]
-> ![Visual Studio 2019 download details](_img/subscriber-downloads/vs2019-info.png)
+> ![Visual Studio 2019 download details](_img/subscriber-downloads/vs2019-info.png "The Info tab displays information about the download and provides access to release notes.")
 
 In the details pane, you can also click on the **Keys** tab to check the status of your product keys.
 > [!div class="mx-imgBorder"]
-> ![Visual Studio 2019 product keys](_img/subscriber-downloads/vs2019-keys.png)
+> ![Visual Studio 2019 product keys](_img/subscriber-downloads/vs2019-keys.png "The Keys tab shows you how many keys you have remaining and allows you to claim available keys.")
 
 ### Obtaining product keys
 To obtain a product key for the download, you can either click the blue key labeled **Get Key** or if you're already viewing the details pane, click on **Claim key** on the **Keys** tab.
 > [!div class="mx-imgBorder"]
-> ![Visual Studio 2019 claim product keys](_img/subscriber-downloads/vs2019-claim-keys.png)
+> ![Visual Studio 2019 claim product keys](_img/subscriber-downloads/vs2019-claim-keys.png "Click Claim Key to claim remaining keys.")
 
 ## See also
 - [Visual Studio documentation](https://docs.microsoft.com/visualstudio/)
@@ -62,7 +62,3 @@ Learn how to take advantage of other great benefits such as:
 - [Azure DevTest individual credit](vs-azure.md)
 - [Azure DevOps](vs-azure-devops.md)
 - [Visual Studio IDE](vs-ide-benefit.md)
-
-
-
-