merge from upstream and bullet see also lists in 4 quickstarts

Author: gewarren

.openpublishing.publish.config.json

@@ -38,6 +38,7 @@
       "build_source_folder": "docs",
       "build_output_subfolder": "vsdocsdocs",
       "locale": "en-us",
+      "xref_query_tags": ["/dotnet"],
       "monikers": [],
       "open_to_public_contributors": true,
       "type_mapping": {

.openpublishing.redirection.json

@@ -67,7 +67,7 @@
             "redirect_url": "https://vspartner.com/pages/vsshells",
             "redirect_document_id": false
         },
-        {   
+        {
             "source_path": "docs/extensibility/shell/distributing-isolated-shell-applications.md",
             "redirect_url": "https://vspartner.com/pages/vsshells",
             "redirect_document_id": false
@@ -1037,6 +1037,21 @@
             "redirect_url": "/visualstudio/ide/reference/call-hierarchy",
             "redirect_document_id": false
         },
+        {
+            "source_path": "docs/ide/reference/installvstemplates-devenv-exe.md",
+            "redirect_url": "/visualstudio/ide/reference/devenv-command-line-switches",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "docs/ide/reference/resetaddin-devenv-exe.md",
+            "redirect_url": "/visualstudio/ide/reference/devenv-command-line-switches",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "docs/ide/reference/updateconfiguration-devenv-exe.md",
+            "redirect_url": "/visualstudio/ide/reference/devenv-command-line-switches",
+            "redirect_document_id": false
+        },
         {
             "source_path": "docs/ide/reference/visual-studio-for-applications-reference.md",
             "redirect_url": "/visualstudio/ide/reference/visual-studio-reference",
@@ -1827,6 +1842,11 @@
             "redirect_url": "/visualstudio/test/unit-test-your-code",
             "redirect_document_id": false
         },
+        {
+            "source_path": "docs/test/lab-management/upgrade-scvmm-2008-r2-scvmm-2012.md",
+            "redirect_url": "/visualstudio/test/lab-management/using-a-lab-environment-for-your-application-lifecycle",
+            "redirect_document_id": false
+        },
         {
             "source_path": "docs/test/using-microsoft-visualstudio-testtools-cppunittestframework.md",
             "redirect_url": "/visualstudio/test/microsoft.visualstudio.testtools.cppunittestframework-api-reference",
@@ -1837,6 +1857,11 @@
             "redirect_url": "/visualstudio/test/writing-unit-tests-for-c-cpp",
             "redirect_document_id": false
         },
+        {
+            "source_path": "docs/test/writing-unit-tests-for-the-dotnet-framework-with-the-microsoft-unit-test-framework-for-managed-code.md",
+            "redirect_url": "/visualstudio/test/unit-test-your-code",
+            "redirect_document_id": false
+        },
         {
             "source_path": "docs/vb-ide/code-generation-vb.md",
             "redirect_url": "/visualstudio/ide/code-generation-in-visual-studio",
@@ -2102,6 +2127,11 @@
           "source_path": "docs/install/install-visual-studio-behind-a-firewall-or-proxy-server.md",
           "redirect_url": "/visualstudio/install/install-and-use-visual-studio-behind-a-firewall-or-proxy-server",
           "redirect_document_id": false
+        },
+        {
+          "source_path": "docs/ide/quickstart-visual-basic-winforms.md",
+          "redirect_url": "/visualstudio/ide/create-a-visual-basic-winform-in-visual-studio",
+          "redirect_document_id": false
         }
     ]
 }

docs/TOC.md

@@ -157,7 +157,7 @@
 ###### [Filtered Completion Lists in Visual Basic](ide/filtered-completion-lists-in-visual-basic.md)
 ##### [C# IntelliSense](ide/visual-csharp-intellisense.md)
 ##### [JavaScript IntelliSense](ide/javascript-intellisense.md)
-##### [Visual C++ Intellisense](ide/visual-cpp-intellisense.md)
+##### [Visual C++ IntelliSense](ide/visual-cpp-intellisense.md)
 #### [Navigate Your Code](ide/navigating-code.md)
 ##### [Find references in your code](ide/finding-references.md)
 ##### [View Type and Member Definitions](ide/go-to-and-peek-definition.md)
@@ -389,15 +389,12 @@
 ### [-Project (devenv.exe)](ide/reference/project-devenv-exe.md)
 ### [-ProjectConfig (devenv.exe)](ide/reference/projectconfig-devenv-exe.md)
 ### [-Rebuild (devenv.exe)](ide/reference/rebuild-devenv-exe.md)
-### [-ResetAddin (devenv.exe)](ide/reference/resetaddin-devenv-exe.md)
-### [-InstallVSTemplates (devenv.exe)](ide/reference/installvstemplates-devenv-exe.md)
 ### [-ResetSettings (devenv.exe)](ide/reference/resetsettings-devenv-exe.md)
 ### [-ResetSkipPkgs (devenv.exe)](ide/reference/resetskippkgs-devenv-exe.md)
 ### [-Run (devenv.exe)](ide/reference/run-devenv-exe.md)
 ### [-Runexit (devenv.exe)](ide/reference/runexit-devenv-exe.md)
 ### [-SafeMode (devenv.exe)](ide/reference/safemode-devenv-exe.md)
 ### [-Setup (devenv.exe)](ide/reference/setup-devenv-exe.md)
-### [-Updateconfiguration (devenv.exe)](ide/reference/updateconfiguration-devenv-exe.md)
 ### [-Upgrade (devenv.exe)](ide/reference/upgrade-devenv-exe.md)
 ### [-UseEnv (devenv.exe)](ide/reference/useenv-devenv-exe.md)
 ## [Visual Studio Commands](ide/reference/visual-studio-commands.md)

docs/code-quality/ca1064-exceptions-should-be-public.md

@@ -36,7 +36,7 @@ ms.workload:
 ## Rule Description  
  An internal exception is only visible inside its own internal scope. After the exception falls outside the internal scope, only the base exception can be used to catch the exception. If the internal exception is inherited from <xref:System.Exception>, <xref:System.SystemException>, or <xref:System.ApplicationException>, the external code will not have sufficient information to know what to do with the exception.  
 
- But, if the code has a public exception that later is used as the base for a internal exception, it is reasonable to assume the code further out will be able to do something intelligent with the base exception. The public exception will have more information than what is provided by T:System.Exception, T:System.SystemException, or T:System.ApplicationException.  
+ But, if the code has a public exception that later is used as the base for a internal exception, it is reasonable to assume the code further out will be able to do something intelligent with the base exception. The public exception will have more information than what is provided by <xref:System.Exception>, <xref:System.SystemException>, or <xref:System.ApplicationException>.  
 
 ## How to Fix Violations  
  Make the exception public, or derive the internal exception from a public exception that is not <xref:System.Exception>, <xref:System.SystemException>, or <xref:System.ApplicationException>.  
@@ -47,4 +47,4 @@ ms.workload:
 ## Example  
  This rule fires on the first example method, FirstCustomException because the exception class derives directly from Exception and is internal. The rule does not fire on the SecondCustomException class because although the class also derives directly from Exception, the class is declared public. The third class also does not fire the rule because it does not derive directly from <xref:System.Exception?displayProperty=fullName>, <xref:System.SystemException?displayProperty=fullName>, or <xref:System.ApplicationException?displayProperty=fullName>.  
 
- [!code-csharp[FxCop.Design.ExceptionsShouldBePublic.CA1064#1](../code-quality/codesnippet/CSharp/ca1064-exceptions-should-be-public_1.cs)]
+ [!code-csharp[FxCop.Design.ExceptionsShouldBePublic.CA1064#1](../code-quality/codesnippet/CSharp/ca1064-exceptions-should-be-public_1.cs)]

docs/cross-platform/change-log-visual-studio-tools-for-unity.md

@@ -17,6 +17,99 @@ ms.workload:
 # Change Log (Visual Studio Tools for Unity)
 Visual Studio Tools for Unity change log.
 
+## 3.6.0.4
+ Released 2018-03-05
+
+### Bug fixes
+
+-   **Project Generation:**
+
+    -   Fixed Mono version detection.
+
+-   **Integration:**
+
+    -   Fixed timing issues with 2018.1 and plugin activation.
+
+## 3.6.0.3
+ Released 2018-02-23
+
+### New Features
+
+-   **Project Generation:**
+
+    -   Added support for .Net Standard.
+
+### Bug fixes
+
+-   **Project Generation:**
+
+    -   Fixed Unity target framework detection.
+
+-   **Debugger:**
+
+    -   Fixed breaking on exceptions that are thrown outside of usercode.
+
+## 3.6.0.2
+ Released 2018-02-07
+
+### New Features
+
+-   **Integration:**
+
+    -   Update UnityMessage API surface for 2017.3.
+
+### Bug fixes
+
+-   **Integration:**
+
+    -   Only reload projects on external change (with throttling).
+ 
+## 3.6.0.1
+ Released 2018-01-24
+
+### Bug fixes
+
+-   **Integration:**
+
+    -   Fixed automatic pdb to mdb debug symbol conversion.
+    
+    -   Fixed indirect call to EditorPrefs.GetBool impacting the inspector while trying to change array size.
+ 
+## 3.6.0.0
+ Released 2018-01-10
+
+### New Features
+
+-   **Project Generation:**
+
+    -   Added support for 2018.1 MonoIsland reference model.
+
+-   **Evaluation:**
+
+    -   Added support for $exception identifier.
+
+-   **Debugger:**
+
+    -   Added support for DebuggerHidden/DebuggerStepThrough attributes with the new Unity runtime.
+    
+-   **Wizards:**
+
+    -   Introduce 'Latest' version for wizards.
+
+### Bug fixes
+
+-   **Project Generation:**
+
+    -   Fixed project guid computation for player projects.
+
+-   **Debugger:**
+
+    -   Fixed a race in handling breaking events.
+    
+-   **Wizards:**
+
+    -   Refresh roslyn context before inserting method.
+
 ## 3.5.0.3
  Released 2018-01-09
 

docs/data-tools/index.md

@@ -5,6 +5,7 @@ ms.author: gewarren
 title: Use data tools in Visual Studio to develop data solutions | Microsoft Docs
 description: Learn about tools for data solutions in Visual Studio.
 ms.technology: "vs-data-tools"
+ms.topic: landing-page
 ms.workload: 
   - "data-storage"
 ---

docs/debugger/how-to-use-intellitrace-step-back.md

@@ -103,4 +103,6 @@ The impact on overall stepping performance depends on your application. The over
     Workaround:
     * Clear all snapshots by ending the debugging session. 
 
+* When debugging an application whose process has a high number of unique memory regions, such as an application that loads a large number of DLLs, stepping performance with snapshots enabled may be impacted. This issue will be addressed in a future version of Windows. If you are experiencing this issue, reach out to us at [email protected]. 
+
 * When saving a file with **Debug > IntelliTrace > Save IntelliTrace session** under events and snapshots mode, the additional data captured from snapshots is not available in the .itrace file. On breakpoint and step events, you see the same information as if you had saved the file in IntelliTrace events only mode. 

docs/debugger/index.md

@@ -2,6 +2,7 @@
 layout: LandingPage
 title: Debugging your Apps in Visual Studio | Microsoft Docs
 description: Learn how use Visual Studio 2017 to debug applications, services, and tools in the language of your choice, for your platforms and devices.
+ms.topic: landing-page
 ms.technology: vs-ide-debug
 ---
 # Debugging in Visual Studio
@@ -218,4 +219,4 @@ The Visual Studio debugger helps you observe the run-time behavior of your progr
     </li>
 </ul>
 
----
+---

docs/docfx.json

@@ -51,7 +51,7 @@
       "uhfHeaderId": "MSDocsHeader-VisualStudio"
     },
     "template": [],
-    "xref": ["missingapi.yml", "../dotnet-xref/_zip/dotnet.zip", "namespaces.4.5.2.zip", "vs.110.zip", "vs.140.zip", "office15.zip"],
+    "xref": ["missingapi.yml", "../dotnet-xref/_zip/dotnet.zip"],
     "dest": "vsdocsdocs"
   }
 }

docs/extensibility/adding-a-submenu-to-a-menu.md

@@ -93,7 +93,7 @@ This walkthrough builds on the demonstration in [Adding a Menu to the Visual Stu
 2.  Add the sub-command. Find the command constructor. Add the following lines just after the call to the `AddCommand` method.  
 
     ```csharp  
-    CommandID subCommandID = new CommandID(CommandSet, (int)TestCommandPackageGuids.cmdidTestSubCmd);  
+    CommandID subCommandID = new CommandID(CommandSet, cmdidTestSubCmd);  
     MenuCommand subItem = new MenuCommand(  
         new EventHandler(SubItemCallback), subCommandID);  
     commandService.AddCommand(subItem);  
@@ -157,4 +157,4 @@ This walkthrough builds on the demonstration in [Adding a Menu to the Visual Stu
 
 ## See Also  
  [Adding a Menu to the Visual Studio Menu Bar](../extensibility/adding-a-menu-to-the-visual-studio-menu-bar.md)   
- [Commands, Menus, and Toolbars](../extensibility/internals/commands-menus-and-toolbars.md)
+ [Commands, Menus, and Toolbars](../extensibility/internals/commands-menus-and-toolbars.md)

docs/extensibility/how-to-create-an-atom-feed-for-a-private-gallery.md

@@ -38,41 +38,40 @@ You can create an Atom (RSS) feed to an intranet location that contains extensio
  The contents of the atom.xml file would resemble the following example:  
 
 ```  
-  <?xml version="1.0" encoding="utf-8" ?>   
-- <feed xmlns="http://www.w3.org/2005/Atom">  
-  <title type="text" />   
-  <id>uuid:bcecded5-97c8-4d24-96f1-7d9e16652433;id=1</id>   
-  <updated>2011-04-14T21:25:48Z</updated>   
-- <entry>  
-  <id>SelectionHighlight..a14874d2-8199-4a60-af8a-11d6447813aa</id>   
-  <title type="text">Highlight all occurrences of selected word</title>   
-  <summary type="text">This extends the editor to highlight ....</summary>   
-  <published>2011-04-14T14:24:51-07:00</published>   
-  <updated>2011-04-14T14:24:22-07:00</updated>   
-- <author>  
-  <name>Microsoft</name>   
-  </author>  
-  <link rel="icon" href="VSIXImages/SelectionHighlight..a14874d2-8199-4a60-af8a-11d6447813aa_Icon_SelectionHighlightIcon.jpg" />   
-  <link rel="previewimage" href="VSIXImages/SelectionHighlight..a14874d2-8199-4a60-af8a-11d6447813aa_PreviewImage_SelectionHighlight.jpg" />   
-  <content type="application/octet-stream" src="SelectionHighlight.vsix" />   
-- <Vsix xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/developer/vsx-syndication-schema/2010">  
-  <Id>SelectionHighlight..a14874d2-8199-4a60-af8a-11d6447813aa</Id>   
-  <Version>1.31</Version>   
-  <References />   
-  <Rating xsi:nil="true" />   
-  <RatingCount xsi:nil="true" />   
-  <DownloadCount xsi:nil="true" />   
-  </Vsix>  
-  </entry>  
-- <entry>  
-  <id>Template_Wizard_239.Microsoft.3b38a7e3-5cbc-4389-a92a-d82tyc2ed592</id>   
-  ...  
-  </entry>  
-  </feed>  
-  
+<?xml version="1.0" encoding="utf-8" ?>   
+<feed xmlns="http://www.w3.org/2005/Atom">  
+<title type="text" />   
+<id>uuid:bcecded5-97c8-4d24-96f1-7d9e16652433;id=1</id>   
+<updated>2011-04-14T21:25:48Z</updated>   
+<entry>  
+<id>SelectionHighlight..a14874d2-8199-4a60-af8a-11d6447813aa</id>   
+<title type="text">Highlight all occurrences of selected word</title>   
+<summary type="text">This extends the editor to highlight ....</summary>   
+<published>2011-04-14T14:24:51-07:00</published>   
+<updated>2011-04-14T14:24:22-07:00</updated>   
+<author>  
+<name>Microsoft</name>   
+</author>  
+<link rel="icon" href="VSIXImages/SelectionHighlight..a14874d2-8199-4a60-af8a-11d6447813aa_Icon_SelectionHighlightIcon.jpg" />   
+<link rel="previewimage" href="VSIXImages/SelectionHighlight..a14874d2-8199-4a60-af8a-11d6447813aa_PreviewImage_SelectionHighlight.jpg" />   
+<content type="application/octet-stream" src="SelectionHighlight.vsix" />   
+<Vsix xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/developer/vsx-syndication-schema/2010">  
+<Id>SelectionHighlight..a14874d2-8199-4a60-af8a-11d6447813aa</Id>   
+<Version>1.31</Version>   
+<References />   
+<Rating xsi:nil="true" />   
+<RatingCount xsi:nil="true" />   
+<DownloadCount xsi:nil="true" />   
+</Vsix>  
+</entry>  
+<entry>  
+<id>Template_Wizard_239.Microsoft.3b38a7e3-5cbc-4389-a92a-d82tyc2ed592</id>   
+...  
+</entry>  
+</feed>
 ```  
 
  Notice that the two link tags refer to screen shots in the generated folder of images.  
 
 ## See Also  
- [Private Galleries](../extensibility/private-galleries.md)
+ [Private Galleries](../extensibility/private-galleries.md)

docs/extensibility/how-to-diagnose-ui-delays-caused-by-extensions.md

@@ -39,7 +39,7 @@ In the following sections, we will go through these steps in more detail.
 
 ## Identifying the trigger scenario
 
-To do diagnose a UI delay, you first need to idetify what (sequence of actions) causes Visual Studio to show the notification. This is in order for you to able to trigger the notification later with logging turned on.
+To do diagnose a UI delay, you first need to identify what (sequence of actions) causes Visual Studio to show the notification. This is in order for you to able to trigger the notification later with logging turned on.
 
 ## Restarting VS with activity logging on
 
@@ -153,3 +153,7 @@ PerfView has detailed guidance under the Help menu that you can use to identify
 * [https://aka.ms/vsthreading](https://aka.ms/vsthreading)
 * [https://aka.ms/vsthreadingcookbook](https://aka.ms/vsthreadingcookbook)
 
+You can also use the new Visual Studio static analyzers for extensions (NuGet package [here](https://www.nuget.org/packages/microsoft.visualstudio.sdk.analyzers)), that provide guidance on best practices for writing efficient extensions. See a list of [VS SDK analyzers](https://github.com/Microsoft/VSSDK-Analyzers/blob/master/doc/index.md) and [threading analyzers](https://github.com/Microsoft/vs-threading/blob/master/doc/analyzers/index.md).
+
+> [!NOTE]
+> If you are unable to address the unresponsiveness due to dependencies you do not have control over (e.g. if your extension has to call synchronous VS services on the UI thread), we would like to know about it. If you are a member of our Visual Studio Partner program, you can contact us by submitting a developer support request. Otherwise, use the 'Report a Problem' tool to submit your feedback and include `"Extension UI Delay Notifications"` in the title. Please also include a detailed description of your analysis.

docs/ide/quickstart-visual-basic-winforms.md renamed to docs/ide/create-a-visual-basic-winform-in-visual-studio.md

@@ -1,24 +1,25 @@
 ---
-title: "Quickstart: Create a Windows Forms app in Visual Studio with Visual Basic | Microsoft Docs"
+title: "Create a Windows Forms app in Visual Studio with Visual Basic | Microsoft Docs"
+description: "Learn how to create a Windows Forms app in Visual Studio with Visual Basic, step-by-step."
 ms.custom: ""
 ms.date: "12/04/2017"
 ms.reviewer: ""
 ms.suite: ""
-ms.technology: 
+ms.technology:
   - "vs-acquisition"
 ms.tgt_pltfrm: ""
-ms.topic: "quickstart"
+ms.topic: "article"
 ms.devlang: "vb"
 author: "TerryGLee"
 ms.author: "tglee"
 manager: ghogen
-dev_langs: 
+dev_langs:
   - vb
-ms.workload: 
+ms.workload:
   - "multiple"
 ---
-# Quickstart: Create a Windows Forms app in Visual Studio with Visual Basic
-In this 5-10 minute introduction to the Visual Studio integrated development environment (IDE), you'll create a simple Visual Basic application that has a Windows-based user interface (UI).
+# Create a Windows Forms app in Visual Studio with Visual Basic
+In this short introduction to the Visual Studio integrated development environment (IDE), you'll create a simple Visual Basic application that has a Windows-based user interface (UI).
 
 If you haven't already installed Visual Studio, go to the [Visual Studio Downloads](https://aka.ms/vsdownload?utm_source=mscom&utm_campaign=msdocs) page to install it for free.