Merge pull request #8509 from MicrosoftDocs/main638000175104756944sync_temp

Jak-MS · web-flow · commit ce9c47e56b80 · 2022-09-29T08:17:10.000-07:00
Repo sync for protected CLA branch
diff --git a/docs/ide/reference/options-text-editor-advanced.md b/docs/ide/reference/options-text-editor-advanced.md
@@ -1,7 +1,7 @@
 ---
 title: Options, Text Editor, Advanced
 description: Learn how to use the Advanced dialog box to change global settings for the Visual Studio text editor.
-ms.date: 08/09/2022
+ms.date: 09/28/2022
 ms.topic: reference
 f1_keywords:
 - VS.ToolsOptionsPages.Text_Editor.Advanced
@@ -95,7 +95,10 @@ Select this option to disable the new [multi-caret selection](../finding-and-rep
 
 ## Use adaptive formatting
 
-Based on your most recently updated file, Visual Studio recognizes whether you prefer to use tabs or spaces for code indentation. The adaptive formatting option is selected by default. When unselected, Visual Studio uses the settings in **Tools** > **Options** > **Text Editor** > **All Languages** > **[Tabs](options-text-editor-all-languages-tabs.md)** instead.
+Based on your most recently updated file, Visual Studio recognizes whether you prefer to use tabs or spaces to indent code. The adaptive formatting option is selected by default. When unselected, Visual Studio uses the settings in **Tools** > **Options** > **Text Editor** > **All Languages** > **[Tabs](options-text-editor-all-languages-tabs.md)** instead.
+
+> [!TIP]
+> You can also change how Visual Studio manages your preferred indent style by using an .*editorconfig* file. For more information, see [Create portable, custom editor settings with EditorConfig](../create-portable-custom-editor-options.md).
 
 ## Fallback support for C#, C++, Java, and TypeScript GoTo symbol navigation
 
diff --git a/docs/ide/reference/options-text-editor-all-languages-tabs.md b/docs/ide/reference/options-text-editor-all-languages-tabs.md
@@ -2,7 +2,7 @@
 title: Options, Text Editor, All Languages, Tabs
 description: Learn how to use the Tabs page in the All Languages section to change the default behavior of the code editor tabs within Visual Studio.
 ms.custom: SEO-VS-2020
-ms.date: 11/04/2016
+ms.date: 09/28/2022
 ms.topic: reference
 f1_keywords:
 - VS.ToolsOptionsPages.Text_Editor.All_Languages.Tabs
@@ -90,6 +90,9 @@ Keep tabs
 
 When selected, indent operations insert as many TAB characters as possible. Each TAB character fills the number of spaces specified in **Tab size**. If the **Indent size** is not an even multiple of the **Tab size**, space characters are added to fill in the difference.
 
+> [!TIP]
+> Adaptive formatting might override your custom tabs settings. You can turn off adaptive formatting by toggling the **[Use adaptive formatting](options-text-editor-advanced.md#use-adaptive-formatting-1)** option in **Text Editor** > **[Advanced](options-text-editor-advanced.md)**. You can also change how Visual Studio manages your preferred indent style by using an .*[editorconfig](../create-portable-custom-editor-options.md)* file.
+
 ## See also
 
 - [Options, Text Editor, All Languages](../../ide/reference/options-text-editor-all-languages.md)
diff --git a/docs/profiling/events-viewer.md b/docs/profiling/events-viewer.md
@@ -16,6 +16,8 @@ ms.workload:
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
 
+In the Performance Profiler, you can collect diagnostic info while your app is running, and then examine the collected information after the app stops like a post-mortem analysis.
+
 The generic events viewer shows app activity through a list of events like module load, thread start, and system configuration. This view helps you better diagnose how your app is doing within the Visual Studio profiler.
 
 ## Setup
@@ -64,7 +66,7 @@ All columns except for the **Text** column are sortable.
 
 ![The event viewer trace](../profiling/media/eventviewertrace.png "The event viewer trace")
 
-The event viewer displays up to 20,000 events at a time. To focus on the events of interest, you can filter the display of events by selecting the event filter. You can also see what percentage of the total number of events occurred for each provider. Hover over a single event filter to see a tooltip that shows the:
+The event viewer displays up to 20,000 events at a time. To focus on the events of interest, you can filter the display of events by selecting the Event filter. You can also see what percentage of the total number of events occurred for each provider, and this information gives you a breakdown of where your time is being spent. Hover over a single event filter to see a tooltip that shows the:
 
 - Event name
 - Provider
diff --git a/docs/profiling/profiling-feature-tour.md b/docs/profiling/profiling-feature-tour.md
@@ -136,7 +136,10 @@ The **CPU Usage** view shows you a list of functions ordered by longest running,
 ::: moniker-end
 
 ::: moniker range=">=vs-2022"
-Double-click on a function that you are interested in, and you will see a more detailed "Call tree" view, with the selected function highlighted. The table shows columns with data such as the time spent in the function, including called functions (**Total CPU**), and a second column that shows the time spent in a function, excluding called functions (**Self CPU**). This data can help you evaluate whether the function itself is a performance bottleneck.
+Double-click on a function that you are interested in, and you will see a more detailed **Call tree** view, with the selected function highlighted. The table shows columns with data such as the time spent in the function, including called functions (**Total CPU**), and a second column that shows the time spent in a function, excluding called functions (**Self CPU**). This data can help you evaluate whether the function itself is a performance bottleneck.
+
+> [!TIP]
+> The Visual Studio profiler supports both collecting and viewing traces. The profiler can also view traces that have been collected previously by other tools, such as dotnet-trace. Dotnet-trace produces sampling results, not an instrumented trace. For more information, see [dotnet-trace](/dotnet/core/diagnostics/dotnet-trace).
 
 ![Diagnostic Tools caller callee "butterfly" view](../profiling/media/vs-2022/prof-tour-call-tree-view.png "Diagnostic Tools Caller Callee View")
 ::: moniker-end
diff --git a/docs/profiling/understanding-performance-collection-methods-perf-profiler.md b/docs/profiling/understanding-performance-collection-methods-perf-profiler.md
@@ -21,7 +21,16 @@ This document outlines the data collection methods that tools within the Visual
 
 ## Sampling
 
-Sampling methods for profiling collect statistical data about the work that is performed by an application during a profiling run. Data collection is done by collecting information on the application at a regular interval or sampling frequency such as every millisecond and then analyzing this data to create a model of where time was spent in the application. The sampling method is lightweight and has little effect on the execution of the application being profiled. Tools in the Performance Profiler that utilize the sampling method include the [CPU Usage](../profiling/cpu-usage.md) tool.
+Sampling collects statistical data about the work that is performed by an application during profiling and it’s a good starting place to find areas to speed up your application. At specified intervals, the Sampling method collects information about the functions that are executing in your application. Data collection is done by collecting information on the application at a regular interval or sampling frequency such as every millisecond. The collected data is analyzed to create a model of where the time was spent in the application. If you need accurate measurements of call times or are looking for performance issues in an application for the first time, then you may want to use sampling.
+
+Sampling has less accuracy in the number of calls, but is low cost to the profiler and has little effect on the execution of the application being profiled. Tools in the Performance Profiler that utilize the sampling method include the [CPU Usage](../profiling/cpu-usage.md) tool.
+
+After you finish data collection, the CPU Usage tool analyzes the captured data and displays the report.
+
+## Tracing
+
+Tracing provides better information on how often a method was executed. If you need accurate measures of call numbers, use tracing.
+Tracing can have a larger impact on the performance of your code during collection, but sampling has only a small overhead. Additionally, tracing can be slower to analyze because it takes longer to view the data after collection.
 
 ## Instrumentation
 
diff --git a/mac/install-behind-a-firewall-or-proxy-server.md b/mac/install-behind-a-firewall-or-proxy-server.md
@@ -41,6 +41,12 @@ Because the Visual Studio for Mac Installer downloads from various domains and d
 | dl.xamarin.com | Installer Packages|
 | dc.services.visualstudio.com| Crash Reporting |
 
+### NuGet
+
+| Domain | Port(s)|Purpose|
+| ----------------------|------------------|------------------|
+| api.nuget.org | 80/443|NuGet API|
+
 ### Third party domains
 
 | Domain| Purpose |
@@ -63,6 +69,8 @@ To make sure that you have access to every feature that you need in Visual Studi
 | addins.monodevelop.com | 80/443| Extension Services |
 | visualstudio-devdiv-c2s.msedge.net | 80/443| Experimental Feature and Notifications |
 | targetednotifications.azurewebsites.net|  80/443| Used to filter a global list of notifications to a list that is applicable only to specific types of machines/usage scenarios|
+| nw-umwatson.events.data.microsoft.com | Crash and Error Reporting | 
+| vortex.data.microsoft.com | Crash and Error Reporting |
 
 ### Identity
 
diff --git a/subscriptions/admin-preferences.md b/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
diff --git a/subscriptions/admin-roles.md b/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**.
diff --git a/subscriptions/cloud-admin.md b/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.
 
diff --git a/subscriptions/mpsa.md b/subscriptions/mpsa.md
diff --git a/subscriptions/open-migration.md b/subscriptions/open-migration.md
diff --git a/subscriptions/volume-license.md b/subscriptions/volume-license.md
