Merge pull request #3088 from MicrosoftDocs/repo_sync_working_branch

Confirm merge from repo_sync_working_branch to master to sync with https://github.com/MicrosoftDocs/visualstudio-docs (branch master)

Author: gewarren

docs/ide/reference/media/nuget-lightbulb.png

@@ -26,6 +26,69 @@ Use the **Advanced** options page to modify the settings for editor formatting,
 
    Enables code analysis on all files in the solution, not just open code files. For more information, see [Full solution analysis](../../code-quality/how-to-enable-and-disable-full-solution-analysis-for-managed-code.md).
 
+## Using Directives
+
+- Place 'System' directives first when sorting usings
+
+   When selected, the **Remove and Sort Usings** command in the right-click menu sorts the `using` directives and places the 'System' namespaces at the top of the list
+
+   Before sorting:
+
+   ```csharp
+   using AutoMapper;
+   using FluentValidation;
+   using System.Collections.Generic;
+   using System.Linq;
+   using Newtonsoft.Json;
+   using System;
+   ```
+   
+   After sorting:
+
+   ```csharp
+   using System;
+   using System.Collections.Generic;
+   using System.Linq;
+   using AutoMapper;
+   using FluentValidation;
+   using Newtonsoft.Json;
+   ```
+   
+- Separate using directive groups
+
+   When selected, the **Remove and Sort Usings** command in the right-click menu separates `using` directives by inserting an empty line between groups of directives that have the same root namespace.
+
+   Before sorting:
+
+   ```csharp
+   using AutoMapper;
+   using FluentValidation;
+   using System.Collections.Generic;
+   using System.Linq;
+   using Newtonsoft.Json;
+   using System;
+   ```
+   
+   After sorting:
+   
+   ```csharp
+   using AutoMapper;
+   
+   using FluentValidation;
+   
+   using Newtonsoft.Json;
+   
+   using System;
+   using System.Collections.Generic;
+   using System.Linq;
+   ```
+   
+- Add usings for types in reference assemblies and NuGet packages 
+
+   When selected, a [Quick Action](../quick-actions.md) is available to install a NuGet package and add a `using` directive for unreferenced types.
+
+   ![Quick Action to install NuGet package in Visual Studio](/docs/ide/references/media/nuget-lightbulb.png)
+  
 ## Highlighting
 
 - Highlight references to symbol under cursor
@@ -50,4 +113,4 @@ Use the **Advanced** options page to modify the settings for editor formatting,
 - [XML Documentation Comments (C# Programming Guide)](/dotnet/csharp/programming-guide/xmldoc/xml-documentation-comments)
 - [Document your code with XML comments (C# Guide)](/dotnet/csharp/codedoc)
 - [Set language-specific editor options](../../ide/reference/setting-language-specific-editor-options.md)
-- [C# IntelliSense](../../ide/visual-csharp-intellisense.md)
+- [C# IntelliSense](../../ide/visual-csharp-intellisense.md)

docs/ide/reference/options-text-editor-csharp-advanced.md

@@ -28,7 +28,7 @@ While you are debugging, you can use the **Diagnostic Tools** window to analyze
 
 The **Diagnostic Tools** window is often the preferred way to profile apps, but for Release builds you can also do a post-mortem analysis of your app instead. If you want more information on different approaches, see [Run profiling tools with or without the debugger](../profiling/running-profiling-tools-with-or-without-the-debugger.md). To see profiling tool support for different app types, see [Which tool should I use?](#which-tool-should-i-use).
 
-> ![NOTE]
+> [!NOTE]
 > You can use the post-mortem tools with Windows 7 and later. Windows 8 and later is required to run profiling tools with the debugger (**Diagnostic Tools** window).
 
 ## Analyze CPU Usage
@@ -162,4 +162,4 @@ Here is a table that lists the different tools Visual Studio offers and the diff
 |[JavaScript Memory](../profiling/javascript-memory.md)|no|yes for HTML, no for XAML|no|
 
 ## See also  
- [Debugging in Visual Studio](../debugger/debugging-in-visual-studio.md)
+ [Debugging in Visual Studio](../debugger/debugging-in-visual-studio.md)