Merge pull request #10459 from rigel512/evanwindom-admin-september-update

Minor text changes to improve style and readability in multiple VSS admin experience articles.

Author: JamesJBarnett

subscriptions/admin-preferences.md

@@ -4,18 +4,18 @@ author: evanwindom
 ms.author: amast
 manager: shve
 ms.assetid: 0fe9eaa4-f589-429e-a443-13bf86637d5a
-ms.date: 07/07/2022
+ms.date: 09/28/2022
 ms.topic: conceptual
 description: Learn how to set preferences for language, contacts, subscription level and others in the Administration Portal
 ---
 
 # Set preferences for your agreements in the admin portal
 
-Super admins can set certain preferences in the Administration portal (admin portal) that will be applied globally for each agreement.  These preferences will automatically populate subscription details for your admins when they are adding subscribers, and can only be modified globally by super admins.  
+Super admins can set certain preferences in the Administration portal (admin portal) that will be applied globally for each agreement.  These preferences will automatically populate subscription details during assignment, simplifying the process for admins.  Once set, agreement preferences can only be modified globally by super admins.  
 
 ## Access preferences
 
-You must be signed in to the [admin portal](https://manage.visualstudio.com) using a sign-in ID that has super admin rights on the agreement in order to view or modify the preferences.  
+To view or modify preferences, you must be signed in to the [admin portal](https://manage.visualstudio.com) using a sign-in ID that has super admin rights on the agreement.  
 
 To set your preferences:
 1. Sign in to the admin portal with an ID that has super admin privileges.
@@ -24,20 +24,20 @@ To set your preferences:
    > ![Admin Preferences button](_img/admin-preferences/admin-preferences-button.png "Screenshot of the Manage subscribers page. The settings icon is highlighted.")
 
 3. Select **Agreement Preferences**.
-A panel will open on the left and your available preferences will be displayed. 
+A side panel will open and your available preferences will be displayed. 
 
    > [!div class="mx-imgBorder"]
    > ![Admin Preferences flyout dialog](_img/admin-preferences/admin-preferences-flyout-2.png "Screenshot of the agreement preferences dialog. The overallocation email notification is selected.")
 
 ## Set your preferences
 
-Let's explore each of the available preferences, and their effects. 
+Here are the preferences you can set, and what they do. 
 
 ### Agreement
 
 If you're a super admin on several agreements, you'll be able to choose the desired agreement in the drop-down on the menu bar.  The preferences you set will apply only to that agreement.  Individual admins can override some of these preferences on a case-by-case basis when assigning subscriptions. 
 
-If there is only one agreement for you email address, it will be displayed and the drop-down will be disabled. 
+If there is only one agreement for your email address, the drop-down will be disabled. 
 
 ### Contact email address
 
@@ -48,23 +48,23 @@ This preference provides a way for your subscribers to reach out to admins by us
 
 ### Default subscription level
 
-You can use this setting to set which subscription levels included in your agreement is selected by default when a subscription is assigned to a user.  Admins can change the setting to any subscription level in your agreement -- this option just prevents having to repeatedly make the most common choice. 
+Here you can set which default subscription level from your agreement is assigned to a user.  Admins can change the subscription level to any level from your agreement -- this option just simplifies the assignment process since most admins will assign the same subscription level to the bulk of their subscribers. 
 
 ### Default communication preferences
 
 Setting a default communication language and locale can streamline the process of assigning subscriptions.  For example, if your development team is based in a different country than your admin team, you can set the preferences best suited to the subscribers' location. These settings can still be changed by all admins for individual subscribers. 
 
 ### Default external subscribers setting
 
-This preference allows you to decide whether admins can add subscribers from outside your organization's tenant/directory.  If you turn this option off, no outside subscribers will be allowed.  If you enable it and an admin attempts to add an outside subscriber, they will be asked to confirm their choice, and will be allowed to assign the subscription. Admins can't override this setting. 
+This security feature allows you to restrict admins from adding subscribers outside your organization's tenant/directory.  Turning this option off prevents assignments to external subscribers. When enabled, if an admin attempts to add an outside subscriber, they will be asked to confirm their choice, and will be allowed to assign the subscription. Admins can't override this setting. 
 
 ### Default downloads setting
 
-Enabling this setting, which is on by default, will enable subscribers to access downloads when admins create new subscriptions.  Admins can still disable downloads on an individual subscription basis.  Disabling access to downloads also disables access to product keys.  
+Enabling this setting, which is on by default, will allow subscribers to access downloads when admins create new subscriptions.  Admins can still disable downloads on an individual subscription basis.  Disabling access to downloads also disables access to product keys.  
 
 ### Overallocation notification 
 
-Opt in to receive an email when assignments on your agreement become overallocated. This email notification will be sent to the [Contact e-mail address](admin-preferences.md#contact-email-address), or all admins on your agreement if there is no Contact e-mail address. Use the drop-down menu to configure the threshold at which you'd like to be notified. 
+Opt in here to receive emails when assignments on your agreement become overallocated. This email notification will be sent to the [Contact e-mail address](admin-preferences.md#contact-email-address), or all admins on your agreement if there is no Contact e-mail address. Use the drop-down menu to configure the threshold at which you'd like to be notified. 
 
 
 ## Frequently asked questions

subscriptions/admin-roles.md

@@ -4,14 +4,14 @@ author: evanwindom
 ms.author: amast
 manager: shve
 ms.assetid: 6601c395-f778-48c1-ab76-cf454b9193e4
-ms.date: 07/07/2022
+ms.date: 09/28/2022
 ms.topic: conceptual
 description: Learn about the super admin and admin roles, and how to assign admins. 
 ---
 
 # Super admins and admins for Visual Studio subscription agreements
 
-There are two different roles in the new Visual Studio Subscriptions Administration Portal for Volume Licensing customers. These roles are like the Primary/Notices Contact role and the Subscriptions Manager role that used to exist in the VLSC.
+There are two different roles in the new Visual Studio Subscriptions Administration Portal for Volume Licensing customers, similar to the Primary/Notices Contact and Subscriptions Manager roles that previously existed in the Volume Licensing Service Center (VLSC).
 
 **Super admins:** When an organization is initially set up, the Primary or Notices Contact becomes a super admin by default. The Primary or Notices Contact can choose to assign additional super admins or admins. A super admin can add and remove other admins as well as subscribers. If there are more than two super admins in the system, a super-admin can delete all but the last two for security.
 
@@ -22,7 +22,7 @@ Watch a demonstration about how to manage admins.
 
 ## Assigning admins
 
-To assign new admins (admins):
+To assign new administrators (admins):
 1. Sign in to https://manage.visualstudio.com using an email address that's assigned as a super admin on the agreement through which the subscriptions were purchased.
 0. Select the tab labeled **Manage Administrators**.
 0. Select **Add**.

subscriptions/cloud-admin.md

@@ -18,7 +18,7 @@ When you purchase Visual Studio monthly subscriptions, as the owner of the Azure
 
 You can purchase monthly subscriptions through the [Visual Studio Marketplace](https://marketplace.visualstudio.com/subscriptions), or by contacting a Cloud Solution Provider. If you purchase through the Visual Studio Marketplace, at the end of the purchase experience, you'll be provided with an opportunity to manage users. Choosing that option will take you to the Visual Studio Subscriptions Administration Portal - [https://manage.visualstudio.com](https://manage.visualstudio.com).
 
-Once you've purchased subscriptions, you can visit the [Administration Portal](https://manage.visualstudio.com) at any time. Just sign in to the portal, and select the appropriate Azure subscription in the upper left corner.
+Once you've purchased subscriptions, you can visit the [Administration Portal](https://manage.visualstudio.com) at any time. Just sign into the portal and select the appropriate Azure subscription in the upper left corner.
 
 As the owner of the Azure subscription used to purchase the monthly subscriptions, you can also assign additional admins.
 

subscriptions/mpsa.md

@@ -4,7 +4,7 @@ author: evanwindom
 ms.author: amast
 manager: shve
 ms.assetid: b331c837-3524-42b7-820e-b4fdd5e12793
-ms.date: 07/11/2022
+ms.date: 09/28/2022
 ms.topic: conceptual
 description:  Learn about managing Visual Studio subscriptions in a Microsoft Products and Services Agreement (MPSA)
 ---
@@ -13,21 +13,21 @@ description:  Learn about managing Visual Studio subscriptions in a Microsoft Pr
 
 If you've purchased Visual Studio Subscriptions through the MPSA program, there are a few things to be aware of before you can become a Visual Studio subscriptions admin and assign subscriptions to your users. If you've already been set up as an admin, you can go directly to the Visual Studio subscriptions [Administration Portal](https://manage.visualstudio.com/).
 
-MPSA customers manage assets purchased through MPSA in a portal called the [Business Center](https://businessaccount.microsoft.com/Customer) that supports functionalities similar to the Volume Licensing Service Center (VLSC). These include viewing your License Summary, Orders, Downloads, Keys, Users, etc. However, Visual Studio subscriptions in MPSA behave much like Cloud Services. The Business Center also uses work accounts to sign in, instead of Microsoft Accounts (MSA). If you access services like Azure Active Directory or Office 365, your email is already a work account. This will allow you to register to Business Center with your existing password. If your organization isn't using cloud services and your email isn't a work account, you may use it to register to the Business Center.
+MPSA customers manage assets purchased through MPSA in a portal called the [Business Center](https://businessaccount.microsoft.com/Customer) (Similar to how the Volume Licensing Service Center (VLSC) is used to manage volume licensing assets). In the Business Center, MPSA customers can view their License Summary, Orders, Downloads, Keys, Users, etc. However, there are some key differences between VLSC and MPSA subscriptions. The Business Center uses work accounts to sign in, instead of Microsoft Accounts (MSA). If you access services like Azure Active Directory or Office 365, your email is already a work account. This will allow you to register for access to Business Center with your business email and password combination, like other cloud services - If your organization isn't using cloud services and your email isn't a work account, you may use a different email to register for access to the Business Center and create a password at the time of registration.
 
-The Visual Studio subscriptions [Administration Portal](https://manage.visualstudio.com/) is where you'll assign subscriptions after you become a Visual Studio subscriptions admin. In MPSA, Visual Studio subscriptions must be provisioned to their respective management portal, which is the Visual Studio Subscriptions Administration Portal. To do that, you need to associate your Purchasing Account to a tenant (example: contoso.onmicrosoft.com).
+The Visual Studio subscriptions [Administration Portal](https://manage.visualstudio.com/) is where you'll assign subscriptions after you become a Visual Studio subscriptions admin. Visual Studio subscriptions purchased through MPSA must be provisioned in the Visual Studio Subscriptions Administration Portal by an admin. To do that, your Purchasing Account must be associated with a tenant (example: contoso.onmicrosoft.com).
 
 There are two types of tenants - managed tenants and unmanaged tenants. A managed tenant refers to a tenant that is already being managed by admins within the organization.
 
-An unmanaged tenant is a tenant without any admins assigned and isn't usable for Online Services such as Office 365. Unmanaged tenants are also created when registering to the Business Center with an email that isn't a work account. If you created a password when you registered on the Business Center, your email wasn't a work account. So an unmanaged tenant was created.
+An unmanaged tenant won't have admins assigned and isn't usable for Online Services such as Office 365. Unmanaged tenants are created when registering to the Business Center with an email that isn't a work account. If you were prompted to create a password when you registered for Business Center access, this indicates that the email you used wasn't a work account. This is how an unmanaged tenant can be created.
 
 Prerequisites to become a Visual Studio Subscriptions administrator
 
 ## Managed tenant
 
 Follow these steps to set up a managed tenant:
 
-1. First, the Purchasing Account must be associated with your company domain/tenant. The association is performed in the Business Center Portal. 
+1. The Purchasing Account must be associated with your company domain/tenant. The association is performed in the Business Center Portal. 
 To associate your account, you must
    + Be a registered user in the Business Center Portal with an Account Administrator or Account Manager role
    + Be a Global Administrator (Company Administrator) or a Billing Administrator in the tenant to which you'd like to link your Purchasing Account.
@@ -40,24 +40,24 @@ To associate your account, you must
    4. Select your **tenant** (example: contoso.onmicrosoft.com).
    5. Select Associate Domain.
 
-   For a more detailed explanation for this process, you may use the Quick Start guides. Download the guide named "Set up and Use Your Online Services".
+   For a more detailed explanation of this process, use the Quick Start guides. Download the guide named "Set up and Use Your Online Services".
 
-   If you're experiencing issues with the domain association or require guidance, contact Business Center support.
+   If you're experiencing issues with the domain association or would like additional guidance, Business Center support can assist.
 
-2. After the Purchasing Account has been associated to your domain, to administer Visual Studio subscriptions on the Visual Studio Subscriptions Administration Portal, you must have at least one of the below roles in either of the user portals. Having more than one of these roles across the two portals is also possible. However, just one is enough, regardless of which portal it is:
+2. After the Purchasing Account has been associated with your domain, you must have at least one of the below roles in either of the user portals to administer Visual Studio subscriptions on the Visual Studio Subscriptions Administration Portal. Having more than one of these roles across the two portals is also possible, although having just one is enough, regardless of which portal it is:
 
    Qualifying roles on the Business Center Portal:
 
    + Account Administrator
    + Account Manager 
 
-   Qualifying roles in the tenant Azure Active Directory where the Purchasing Account is associated:
+   Qualifying roles on the tenant Azure Active Directory where the Purchasing Account is associated:
 
    + Global administrator (Company administrator)
    + User Administrator
 
 > [!NOTE]
-> For the Azure Active Directory roles, ensure that the “Country or Region” and “Postal code” fields within your user profile in Azure are populated appropriately depending on your region (i.e. US, CA, etc.).
+> For the Azure Active Directory roles, ensure that the “Country or Region” and “Postal code” fields within your Azure user profile are populated appropriately depending on your region (i.e. US, CA, etc.).
 
 After the domain association, if you have the correct permissions listed above, you'll be able to access the Visual Studio Subscriptions Administration Portal within 24 hours. If you don't have access after 24 hours, contact Business Center support.
 

subscriptions/open-migration.md

@@ -4,19 +4,17 @@ author: evanwindom
 ms.author: amast
 manager: shve
 ms.assetid: 6866dfab-c4fa-428e-bb0d-7b202c81f770
-ms.date: 07/12/2022
+ms.date: 09/28/2022
 ms.topic: conceptual
 description:  Learn how partners manage Visual Studio subscriptions for their customers.
 ---
 
 # Partners managing subscriptions on behalf of customers
 
-To manage subscriptions in the Visual Studio [Subscriptions Administration Portal](https://manage.visualstudio.com), there are a few steps partners need to follow. 
+To manage subscriptions in the Visual Studio [Subscriptions Administration Portal](https://manage.visualstudio.com), there are a few steps that partners need to follow. 
 
-The process is:
-+ Partners place a new order on behalf of a customer, entering the customer’s business email address.
-+ The customer receives a notification inviting them to assign admins and access their subscriptions in the [Visual Studio Subscriptions Administration Portal](https://manage.visualstudio.com).
-+ For partners to manage subscriptions on behalf of customers, they will need to register on the admin portal. The various ways to access gain access are listed below (similar to the add-open process).
+After a partner places a new order on behalf of a customer, the customer will receive a notification inviting them to assign admins and access their subscriptions in the [Visual Studio Subscriptions Administration Portal](https://manage.visualstudio.com).
++ For partners to manage subscriptions on behalf of customers, they will need to register on the admin portal. The various ways to gain access are listed below (similar to the add-open process).
 
 ## New partners visiting the Visual Studio Subscriptions Administration Portal directly
 
@@ -25,7 +23,7 @@ This scenario applies to new partners who have already placed new Open License o
 1. You receive a notification that you're not a recognized user.
 1. Select the **OLP Partners** registration option
 1. Enter the authorization number, license number, customer email address used on the order 
-1. Select the checkbox
+1. Check the box, indicating your acknowledgment regarding the permissions listed
 1. Select **Submit**.
 
 > [!NOTE]
@@ -53,7 +51,7 @@ This applies to partners that already have access to the [Visual Studio Subscrip
 Steps for partners to add a new license:
 1. Sign in to <https://manage.visualstudio.com>.
 1. Next to the agreement dropdown, select + Add agreement and choose and scroll to the bottom where there is an option to **New open license**.
-1. In the pop-out panel, enter the authorization number, license number, customer email address that is on the agreement, select the checkbox, and then select **Submit**.
+1. In the pop-out panel, enter the authorization number, license number, customer email address that is on the agreement, check the box if you agree, and then select **Submit**.
 
 > [!NOTE]
 > The customer will receive a notification email informing them that a Partner has been added to the Open License. They can choose to remove the Partner’s access.