Merge pull request #267 from Microsoft/master

merge master to live

Author: Greg Van Liew

docs/extensibility/TOC.md

@@ -12,7 +12,6 @@
 # [How to: Migrate Extensibility Projects to Visual Studio 2017](how-to-migrate-extensibility-projects-to-visual-studio-2017.md)
 # [What's New in the Visual Studio 2015 SDK](what-s-new-in-the-visual-studio-2015-sdk.md)
 # [How to: Migrate Extensibility Projects to Visual Studio 2015](how-to-migrate-extensibility-projects-to-visual-studio-2015.md)
-# [FAQ: Converting Add-ins to VSPackage Extensions](faq-converting-add-ins-to-vspackage-extensions.md)
 # [Extending Menus and Commands](extending-menus-and-commands.md)
 ## [Creating an Extension with a Menu Command](creating-an-extension-with-a-menu-command.md)
 ## [Adding a Menu to the Visual Studio Menu Bar](adding-a-menu-to-the-visual-studio-menu-bar.md)
@@ -174,17 +173,16 @@
 # [Visual Studio User Experience Guidelines](ux-guidelines/TOC.md)
 # [Addressing DPI Issues](addressing-dpi-issues2.md)
 # [Image Service and Catalog](image-service-and-catalog.md)
-# [Managing Multiple Threads in Managed Code](managing-multiple-threads-in-managed-code.md)
 # [Using and Providing Services](using-and-providing-services.md)
 ## [How to: Get a Service](how-to-get-a-service.md)
 ## [How to: Provide a Service](how-to-provide-a-service.md)
 ## [How to: Provide an Asynchronous Visual Studio Service](how-to-provide-an-asynchronous-visual-studio-service.md)
 ## [How to: Troubleshoot Services](how-to-troubleshoot-services.md)
-# [Extending Connected Services](extending-connected-services.md)
 # [Managing VSPackages](managing-vspackages.md)
 ## [The Experimental Instance](the-experimental-instance.md)
 ## [Registering and Unregistering VSPackages](registering-and-unregistering-vspackages.md)
 ## [Loading VSPackages](loading-vspackages.md)
+## [How to: Managing Multiple Threads in Managed Code](managing-multiple-threads-in-managed-code.md)
 ## [How to: Use AsyncPackage to Load VSPackages in the Background](how-to-use-asyncpackage-to-load-vspackages-in-the-background.md)
 ## [How to: Use Rule-based UI Context for Visual Studio Extensions](how-to-use-rule-based-ui-context-for-visual-studio-extensions.md)
 ## [How to: Diagnose extension performance](how-to-diagnose-extension-performance.md)
@@ -236,54 +234,6 @@
 #### [Managing Side-by-Side File Associations](managing-side-by-side-file-associations.md)
 # [Inside the Visual Studio SDK](internals/TOC.md)
 # [Support for the Visual Studio SDK](support-for-the-visual-studio-sdk.md)
-# [Archive](archive.md)
-## [Legacy Interfaces in the Editor](legacy-interfaces-in-the-editor.md)
-### [Adapting Legacy Code to the Editor](adapting-legacy-code-to-the-editor.md)
-### [New or Changed Behavior with Editor Adapters](new-or-changed-behavior-with-editor-adapters.md)
-### [Inside the Core Editor](inside-the-core-editor.md)
-### [Instantiating the Core Editor By Using the Legacy API](instantiating-the-core-editor-by-using-the-legacy-api.md)
-### [Editor Factories](editor-factories.md)
-### [How to: Register Editor File Types](how-to-register-editor-file-types.md)
-### [Walkthrough: Creating a Core Editor and Registering an Editor File Type](walkthrough-creating-a-core-editor-and-registering-an-editor-file-type.md)
-### [How to: Provide Context for Editors](how-to-provide-context-for-editors.md)
-### [Language Services and the Core Editor](language-services-and-the-core-editor.md)
-#### [Providing a Language Service Context by Using the Legacy API](providing-a-language-service-context-by-using-the-legacy-api.md)
-#### [IntelliSense Hosting](intellisense-hosting.md)
-#### [Contained Languages](contained-languages.md)
-### [Accessing the Text Buffer by Using the Legacy API](accessing-the-text-buffer-by-using-the-legacy-api.md)
-#### [Text Buffer Events in the Legacy API](text-buffer-events-in-the-legacy-api.md)
-#### [How to: Register for Text Buffer Events with the Legacy API](how-to-register-for-text-buffer-events-with-the-legacy-api.md)
-### [Accessing theText View by Using the Legacy API](accessing-thetext-view-by-using-the-legacy-api.md)
-#### [Changing View Settings by Using the Legacy API](changing-view-settings-by-using-the-legacy-api.md)
-#### [Using the Text Manager to Monitor Global Settings](using-the-text-manager-to-monitor-global-settings.md)
-### [Customizing Code Windows by Using the Legacy API](customizing-code-windows-by-using-the-legacy-api.md)
-#### [How to: Host An Editor in Another Editor](how-to-host-an-editor-in-another-editor.md)
-#### [How to: Fire Events When the Editor Loses Focus](how-to-fire-events-when-the-editor-loses-focus.md)
-### [Accessing Text Layers by Using the Legacy API](accessing-text-layers-by-using-the-legacy-api.md)
-### [Using Text Markers with the Legacy API](using-text-markers-with-the-legacy-api.md)
-#### [How to: Add Standard Text Markers](how-to-add-standard-text-markers.md)
-#### [How to: Implement Error Markers](how-to-implement-error-markers.md)
-#### [How to: Create Custom Text Markers](how-to-create-custom-text-markers.md)
-#### [How to: Use Text Markers](how-to-use-text-markers.md)
-### [Customizing Editor Controls and Menus by Using the Legacy API](customizing-editor-controls-and-menus-by-using-the-legacy-api.md)
-#### [Drop-down Bar](drop-down-bar.md)
-#### [Command Handling](command-handling.md)
-#### [Context Menus](context-menus.md)
-#### [How to: Update the Status Bar](how-to-update-the-status-bar.md)
-### [Managing Undo and Redo by Using the Legacy API](managing-undo-and-redo-by-using-the-legacy-api.md)
-#### [How to: Implement Undo Management](how-to-implement-undo-management.md)
-#### [How to: Clear the Undo Stack](how-to-clear-the-undo-stack.md)
-#### [How to: Use Linked Undo Management](how-to-use-linked-undo-management.md)
-### [How to: Implement the Find and Replace Mechanism](how-to-implement-the-find-and-replace-mechanism.md)
-### [How to: Suppress File Change Notifications](how-to-suppress-file-change-notifications.md)
-### [Using Fonts and Colors](using-fonts-and-colors.md)
-#### [Font and Color Overview](font-and-color-overview.md)
-#### [Getting Font and Color Information for Text Colorization](getting-font-and-color-information-for-text-colorization.md)
-#### [Accessing Stored Font and Color Settings](accessing-stored-font-and-color-settings.md)
-#### [Implementing Custom Categories and Display Items](implementing-custom-categories-and-display-items.md)
-#### [How to: Access the Built-in Fonts and Color Scheme](how-to-access-the-built-in-fonts-and-color-scheme.md)
-## [Tool Windows in the Registry](tool-windows-in-the-registry.md)
-### [Tool Window Display Configuration](tool-window-display-configuration.md)
 # [Visual Studio SDK Reference](visual-studio-sdk-reference.md)
 ## [IntelliSenseHostFlags](intellisensehostflags.md)
 ## [VSCT XML Schema Reference](vsct-xml-schema-reference.md)
@@ -401,4 +351,3 @@
 # [.NET Compiler Platform ("Roslyn") Extensibility](dotnet-compiler-platform-roslyn-extensibility.md)
 ## [Getting Started with Roslyn Analyzers](getting-started-with-roslyn-analyzers.md)
 ## [Roslyn Analyzers and Code-aware Library for ImmutableArrays](roslyn-analyzers-and-code-aware-library-for-immutablearrays.md)
-# [Enabling the Azure SDK](enabling-the-azure-sdk.md)

docs/extensibility/enabling-the-azure-sdk.md

@@ -35,7 +35,4 @@ Visual Studio gives you a lot of extensibility options. You can create your own
  Find out how to create, package, and deploy your own platform and extension SDKs: [Creating a Software Development Kit](../extensibility/creating-a-software-development-kit.md).  
 
 ## Roslyn Extensibility  
- Find out how to use Roslyn for extensibility: [.NET Compiler Platform ("Roslyn") Extensibility](../extensibility/dotnet-compiler-platform-roslyn-extensibility.md).  
-  
-## Azure SDK  
- Find out how to enable the Azure SDK: [Enabling the Azure SDK](../extensibility/enabling-the-azure-sdk.md).
+ Find out how to use Roslyn for extensibility: [.NET Compiler Platform ("Roslyn") Extensibility](../extensibility/dotnet-compiler-platform-roslyn-extensibility.md).

docs/extensibility/extending-connected-services.md

@@ -1,5 +1,5 @@
 ---
-title: "Managing Multiple Threads in Managed Code | Microsoft Docs"
+title: "How to: Managing Multiple Threads in Managed Code | Microsoft Docs"
 ms.custom: ""
 ms.date: "11/04/2016"
 ms.reviewer: ""
@@ -27,7 +27,7 @@ translation.priority.mt:
   - "zh-cn"
   - "zh-tw"
 ---
-# Managing Multiple Threads in Managed Code
+# How to: Managing Multiple Threads in Managed Code
 If you have a managed VSPackage extension that calls asynchronous methods or has operations that execute on threads other than the Visual Studio UI thread, you should follow the guidelines given below. You can keep the UI thread responsive because it doesn’t need to wait for work on another thread to complete. You can make your code more efficient, because you don’t have extra threads that take up stack space, and you can make it more reliable and easier to debug because you avoid deadlocks and hangs.  
 
  In general, you can switch from the UI thread to a different thread, or vice versa. When the method returns, the current thread is the thread from which it was originally called.  

docs/extensibility/extensibility-in-visual-studio.md

@@ -1,17 +1,17 @@
 # [Visual Studio User Experience Guidelines](visual-studio-user-experience-guidelines.md)
-## [UX Essentials for Visual Studio](ux-essentials-for-visual-studio.md)
-## [Fonts and Formatting for Visual Studio](fonts-and-formatting-for-visual-studio.md)
-## [Colors and Styling for Visual Studio](colors-and-styling-for-visual-studio.md)
-### [Shared Colors for Visual Studio](shared-colors-for-visual-studio.md)
-## [Images and Icons for Visual Studio](images-and-icons-for-visual-studio.md)
-### [Visual Language Dictionary for Visual Studio](visual-language-dictionary-for-visual-studio.md)
-## [Menus and Commands for Visual Studio](menus-and-commands-for-visual-studio.md)
-## [Interaction Patterns for Visual Studio](interaction-patterns-for-visual-studio.md)
-### [Application Patterns for Visual Studio](application-patterns-for-visual-studio.md)
-### [Common Control Patterns for Visual Studio](common-control-patterns-for-visual-studio.md)
-### [Composite Patterns for Visual Studio](composite-patterns-for-visual-studio.md)
-## [UI Text and Help for Visual Studio](ui-text-and-help-for-visual-studio.md)
-## [Layout for Visual Studio](layout-for-visual-studio.md)
-## [Notifications and Progress for Visual Studio](notifications-and-progress-for-visual-studio.md)
-## [Animations for Visual Studio](animations-for-visual-studio.md)
-## [Evaluation Tools for Visual Studio](evaluation-tools-for-visual-studio.md)
+# [UX Essentials for Visual Studio](ux-essentials-for-visual-studio.md)
+# [Fonts and Formatting for Visual Studio](fonts-and-formatting-for-visual-studio.md)
+# [Colors and Styling for Visual Studio](colors-and-styling-for-visual-studio.md)
+## [Shared Colors for Visual Studio](shared-colors-for-visual-studio.md)
+# [Images and Icons for Visual Studio](images-and-icons-for-visual-studio.md)
+## [Visual Language Dictionary for Visual Studio](visual-language-dictionary-for-visual-studio.md)
+# [Menus and Commands for Visual Studio](menus-and-commands-for-visual-studio.md)
+# [Interaction Patterns for Visual Studio](interaction-patterns-for-visual-studio.md)
+## [Application Patterns for Visual Studio](application-patterns-for-visual-studio.md)
+## [Common Control Patterns for Visual Studio](common-control-patterns-for-visual-studio.md)
+## [Composite Patterns for Visual Studio](composite-patterns-for-visual-studio.md)
+# [UI Text and Help for Visual Studio](ui-text-and-help-for-visual-studio.md)
+# [Layout for Visual Studio](layout-for-visual-studio.md)
+# [Notifications and Progress for Visual Studio](notifications-and-progress-for-visual-studio.md)
+# [Animations for Visual Studio](animations-for-visual-studio.md)
+# [Evaluation Tools for Visual Studio](evaluation-tools-for-visual-studio.md)

docs/extensibility/managing-multiple-threads-in-managed-code.md

@@ -100,7 +100,6 @@ The Visual Studio SDK helps you extend Visual Studio features or integrate new f
  [Extending Properties and the Property Window](../extensibility/extending-properties-and-the-property-window.md)   
  [Extending Other Parts of Visual Studio](../extensibility/extending-other-parts-of-visual-studio.md)   
  [Using and Providing Services](../extensibility/using-and-providing-services.md)   
- [Extending Connected Services](../extensibility/extending-connected-services.md)   
  [Managing VSPackages](../extensibility/managing-vspackages.md)   
  [Visual Studio Isolated Shell](../extensibility/visual-studio-isolated-shell.md)   
  [Shipping Visual Studio Extensions](../extensibility/shipping-visual-studio-extensions.md)   

docs/extensibility/ux-guidelines/TOC.md

@@ -66,6 +66,8 @@ If no command is specified, it will install the product.
 | ```--nickname <name>``` | Optional: This defines the nickname to assign to an installed product. The nickname cannot be longer than 10 characters.  |
 | ```--help, --?, -h, -?``` | Display parameter usage. |
 
+>Note: When specifying multiple workloads and components, you must repeat the `--add` or `--remove` command line switch for each item.
+
 | **Advanced command-line option** | **Description** |
 | ----------------------- | --------------- |  
 | ```--channelId <id>``` | Optional: The ID of the channel for the instance that will be installed. This is required for the install command, ignored for other commands if --installPath is specified. |

docs/extensibility/visual-studio-sdk.md

@@ -1,8 +1,4 @@
-# [chakra-hosting](chakra-hosting\TOC.md)
-# [javascript](javascript\TOC.md)
-# [advanced](javascript\advanced\TOC.md)
-# [misc](javascript\misc\TOC.md)
-# [reference](javascript\reference\TOC.md)
-# [jswinrt](jswinrt\TOC.md)
-# [winscript](winscript\TOC.md)
-# [reference](winscript\reference\TOC.md)
+# [JavaScript](javascript\TOC.md)
+# [JavaScript and the Windows Runtime](jswinrt\TOC.md)
+# [JavaScript Runtime](chakra-hosting\TOC.md)
+# [Windows Script](winscript\TOC.md)

docs/install/use-command-line-parameters-to-install-visual-studio.md

@@ -0,0 +1,32 @@
+- name: Docs
+  tocHref: /
+  topicHref: /
+  items:
+  - name: Scripting
+    tocHref: /script/
+    topicHref: /script
+    items:
+    - name: JavaScript
+      tocHref: /script/javascript
+      topicHref: /script/javascript/javascript-language-reference
+      items:
+      - name: Advanced
+        tocHref: /script/javascript/advanced/
+        topicHref: /script/javascript/advanced/advanced-javascript
+      - name: Reference
+        tocHref: /script/javascript/reference/
+        topicHref: /script/javascript/reference/javascript-reference
+    - name: Windows Scripting Interfaces
+      tocHref: /script/winscript/
+      topicHref: /script/winscript/windows-scripting-interfaces
+      items:
+      - name: Reference
+          tocHref: /script/winscript/reference
+          topicHref: /script/winscript/reference/windows-script-interfaces-reference
+    - name: JavaScript Runtime Hosting
+      tocHref: /script/chakra-hosting/
+      topicHref: /script/chakra-hosting/javascript-runtime-hosting
+    - name: Windows Runtime
+      tocHref: /script/jswinrt
+      topicHref: /script/jswinrt/using-the-windows-runtime-in-javascript
+