Repo sync for protected CLA branch

docs/ide/how-to-change-fonts-and-colors-in-visual-studio.md

@@ -1,6 +1,6 @@
 ---
-title: How to change font colors, text size, and high-contrast options
-description: Learn how to change the font color and the text size in Visual Studio, and how to select contrast options for accessibility concerns.
+title: Change themes, fonts, text, and contrast for accessibility
+description: Learn how to change Visual Studio color themes, font colors, text sizes, and extra-contrast colors for ease of use and accessibility concerns.
 ms.date: 08/20/2020
 ms.topic: how-to
 ms.custom: contperfq1
@@ -14,9 +14,9 @@ manager: jillfra
 ms.workload:
 - multiple
 ---
-# How to: Change fonts, colors, and high-contrast options in Visual Studio
+# How to: Change fonts, colors, and themes in Visual Studio
 
-You can change the fonts and the colors in Visual Studio in many ways. For example, you can change the default blue color theme to the dark theme (also referred to as "dark mode"). And, you can change the default font and text size to a different font and size. You can also select a high-contrast theme if that best suits your needs.
+You can change the fonts and the colors in Visual Studio in many ways. For example, you can change the default blue color theme to the dark theme (also referred to as "dark mode"). You can also select a extra-contrast theme if that best suits your needs. And, you can change the default font and text size in both the IDE and the code editor.
 
 ## Change the color theme
 
@@ -118,5 +118,6 @@ To learn more details about all the user interface (UI) elements for which you c
 
 ## See also
 
-- [Change fonts and colors for the code editor](../ide/reference/how-to-change-fonts-and-colors-in-the-editor.md)
-- [Features of the Visual Studio code editor](../ide/writing-code-in-the-code-and-text-editor.md)
+- [How to: Change fonts and colors for the editor in Visual Studio](../ide/reference/how-to-change-fonts-and-colors-in-the-editor.md)
+- [Features of the Visual Studio code editor](../ide/writing-code-in-the-code-and-text-editor.md)
+- [Personalize the Visual Studio IDE and the editor](../ide/quickstart-personalize-the-ide.md)

docs/ide/not-in-toc/change-f1-help-key.md

@@ -0,0 +1,33 @@
+---
+title: Change the F1 help key
+description: "Describes how to re-map or remove the F1 key mapping"
+ms.date: 08/20/2020
+ms.topic: how-to
+ms.custom: contperfq1
+robots: noindex,nofollow
+manager: jillfra
+author: mikejo5000
+ms.author: mikejo
+---
+# Change the F1 help key in Visual Studio
+
+If you want to use the F1 key for a different function than the F1 help service, or you just want to disable the help using F1, you can remove or modify the key mapping.
+
+> [!IMPORTANT]
+> If you want to disable F1 help due to performance issues, we recommend you modify the key mapping temporarily so you can test improvements to the F1 help service in updates to Visual Studio. In most scenarios, F1 is an easy way to open reference pages for language keywords and APIs from the code editor, or to open help pages associated with windows or UI elements in the IDE. If you disable it, you disable it for all uses from within Visual Studio.
+
+**To disable the F1 help:**
+
+1. In Visual Studio, select **Tools** > **Options**, then under **Environment**, select **Keyboard**.
+
+1. In the **Show commands containing** text box, type **Help.f1** to filter the view of commands.
+
+   ![Disable F1 Help](../not-in-toc/media/disable-f1-help-key.png)
+
+1. Select **Remove** to remove the key mapping.
+
+1. Select the **Press shortcut key** text box.
+
+1. On your keyboard, press a new key or key combination for the F1 help such as **Alt + F1**, select **Assign**, and then select **OK**.
+
+For more information on setting keyboard shortcuts, see [Identify and customize keyboard shortcuts](../../ide/identifying-and-customizing-keyboard-shortcuts-in-visual-studio.md).

docs/ide/not-in-toc/default-f1-text-editor.md

@@ -0,0 +1,50 @@
+---
+title: Default F1 help page for the text editor
+description: "Default page for F1 help requests for the Visual Studio text editor"
+ms.date: 08/20/2020
+ms.topic: troubleshooting
+ms.custom: contperfq1
+robots: noindex,nofollow
+f1_keywords:
+- vs.texteditor
+manager: jillfra
+author: mikejo5000
+ms.author: mikejo
+---
+# F1 help for the text editor
+
+It looks like we couldn't find what you were looking for, and we apologize. You can help us improve by leaving feedback through the buttons at the bottom of this page, or try one of the following suggestions.
+
+## Cursor position
+
+If you're looking for F1 help on a keyword or API name, be sure you position the cursor inside or just to the right of the word before you press **F1**. If that doesn't fix the issue, try one of the following suggestions.
+
+## Find help on a keyword or API
+
+- For C# help, see the [C# programming guide](/dotnet/csharp/programming-guide/) or [language reference](/dotnet/csharp/language-reference/).
+- For Visual Basic help, see the [Visual Basic language features](/dotnet/visual-basic/programming-guide/language-features/) or [language reference](/dotnet/visual-basic/language-reference/).
+- For Python help, see [Python documentation](https://docs.python.org/).
+- For C++ help, see [C/C++ language and standard libraries reference](/cpp/cpp/c-cpp-language-and-standard-libraries).
+- For F# help, see the [F# guide](/dotnet/fsharp/).
+- For TypeScript help, see the [TypeScript documentation](https://www.typescriptlang.org/docs).
+
+## Search for help on a keyword or API name
+
+If you're looking for F1 help on a keyword or API name:
+- Try searching on [docs.microsoft.com](https://docs.microsoft.com)
+- Try searching using a search engine.
+- Search for reference documentation on [.NET API browser](/dotnet/api/).
+
+## Find the source code for an API
+
+If the source code is available from your project, place your cursor inside the API in the code editor, open the right-click context menu and select **Go to Definition**. For more information, see [View type and member definitions](../../ide/go-to-and-peek-definition.md).
+
+## Re-map or disable the F1 help key
+
+If you want to change the key mapping for F1, see [Change the F1 help key](../not-in-toc/change-f1-help-key.md).
+
+## Useful links
+
+- For help on the Visual Studio text editor, see [Use the code editor](../../ide/writing-code-in-the-code-and-text-editor.md).
+- Browse a list of Knowledge Base articles on the [Visual Studio troubleshooting](/troubleshoot/visualstudio/welcome-visual-studio/) page.
+- For information about Visual Studio, see [Visual Studio overview](../../get-started/visual-studio-ide.md).

docs/ide/not-in-toc/default.md

@@ -1,31 +1,43 @@
 ---
 title: Default page for F1 help
-ms.date: 07/20/2020
+description: "Default page for F1 help requests for Visual Studio"
+ms.date: 08/20/2020
 ms.topic: troubleshooting
+ms.custom: contperfq1
 robots: noindex,nofollow
 f1_keywords:
-- vs.texteditor
 - vs.ambient
 manager: jillfra
-author: TerryGLee
-ms.author: tglee
+author: mikejo5000
+ms.author: mikejo
 ---
 # F1 help
 
-It looks like we couldn't find what you were looking for, and we apologize. You can help us improve by leaving feedback through the buttons at the bottom of this page.
+It looks like we couldn't find what you were looking for, and we apologize. You can help us improve by leaving feedback through the buttons at the bottom of this page, or try one of the following suggestions.
 
-## Cursor position
+## Search for help
 
-If you're looking for F1 help on a keyword or API name, be sure you position the cursor inside or just to the right of the word before you press **F1**. If that still doesn't work, select from the following [useful links](#useful-links) list, or do a search on https://docs.microsoft.com.
+If you're looking for F1 help on a window, a keyword, or an API name:
+
+- Try searching on [docs.microsoft.com](https://docs.microsoft.com)
+- Try searching using a search engine.
+
+## Find help on a keyword or API
+
+- For C# help, see the [C# programming guide](/dotnet/csharp/programming-guide/) or [language reference](/dotnet/csharp/language-reference/).
+- For Visual Basic help, see the [Visual Basic language features](/dotnet/visual-basic/programming-guide/language-features/) or [language reference](/dotnet/visual-basic/language-reference/).
+- For Python help, see [Python documentation](https://docs.python.org/).
+- For C++ help, see [C/C++ language and standard libraries reference](/cpp/cpp/c-cpp-language-and-standard-libraries).
+- For F# help, see the [F# guide](/dotnet/fsharp/).
+- For TypeScript help, see the [TypeScript documentation](https://www.typescriptlang.org/docs).
+
+## Re-map or disable the F1 help key
+
+If you want to change the key mapping for F1, see [Change the F1 help key](../not-in-toc/change-f1-help-key.md).
 
 ## Useful links
 
 - Search for reference documentation on [.NET API browser](/dotnet/api/).
+- For help on the Visual Studio text editor, see [Use the code editor](../../ide/writing-code-in-the-code-and-text-editor.md).
 - Browse a list of Knowledge Base articles on the [Visual Studio troubleshooting](/troubleshoot/visualstudio/welcome-visual-studio/) page.
-- For C# help, see the [C# guide](/dotnet/csharp/index).
-- For Visual Basic help, see the [Visual Basic guide](/dotnet/visual-basic/).
-- For F# help, see the [F# guide](/dotnet/fsharp/).
-- For Python help, see [Python in Visual Studio](../../python/overview-of-python-tools-for-visual-studio.md).
-- For C++ help, see [C++ in Visual Studio](/cpp/visual-cpp-in-visual-studio).
 - For information about Visual Studio, see [Visual Studio overview](../../get-started/visual-studio-ide.md).
-- For help on the Visual Studio text editor, see [Use the code editor](../../ide/writing-code-in-the-code-and-text-editor.md).

docs/ide/quickstart-personalize-the-ide.md

@@ -1,6 +1,6 @@
 ---
-title: How to use the dark theme and change the text color in the editor
-description: Learn how to set the default Visual Studio color theme to dark mode and change font colors in the text editor.
+title: Set the Visual Studio dark theme and change text colors
+description: Learn how to change the default Visual Studio color theme to dark mode and change font colors in the code editor.
 ms.date: 08/20/2020
 ms.topic: how-to
 ms.custom: contperfq1
@@ -10,9 +10,9 @@ manager: jillfra
 ms.workload:
 - multiple
 ---
-# How to: Personalize the Visual Studio IDE and text editor
+# How to: Personalize the Visual Studio IDE and the editor
 
-In this how-to article, we'll customize the Visual Studio color theme by selecting the dark theme. We'll also customize the colors for two different types of text in the text editor.
+In this how-to article, we'll customize the Visual Studio color theme from the default blue theme to the dark theme. Then, we'll customize the colors for two different types of text in the code editor.
 
 ::: moniker range="vs-2017"
 
@@ -120,10 +120,10 @@ Now we'll customize some text colors for the editor. First, let's create a new X
 
    ![XML file with new font colors](media/quickstart-personalize-xml-file-new-colors.png)
 
-We explored just a couple ways of customizing the colors in Visual Studio. We hope that you'll explore the other customization options in the **Options** dialog box, to truly make Visual Studio your own.
+We explored just a couple ways of customizing the colors in Visual Studio. We hope that you'll explore the other customization options in the [**Options**](../ide/reference/fonts-and-colors-environment-options-dialog-box.md) dialog box, to truly make Visual Studio your own.
 
 ## See also
 
-- [Change fonts, colors, and high-contrast options in Visual Studio](../ide/how-to-change-fonts-and-colors-in-visual-studio.md)
-- [Customize the editor](../ide/how-to-change-text-case-in-the-editor.md)
-- [Visual Studio IDE Overview](../get-started/visual-studio-ide.md)
+- [How to: Change fonts, colors, and themes in Visual Studio](../ide/how-to-change-fonts-and-colors-in-visual-studio.md)
+- [How to: Change text case in the editor](../ide/how-to-change-text-case-in-the-editor.md)
+- [Visual Studio IDE overview](../get-started/visual-studio-ide.md)

docs/ide/whats-new-visual-studio-2019.md

@@ -2,7 +2,7 @@
 title: "What's new in Visual Studio 2019"
 titleSuffix: ""
 description: "Learn about the new features in Visual Studio 2019."
-ms.date: 08/05/2020
+ms.date: 08/21/2020
 helpviewer_keywords:
   - "Visual Studio, what's new"
   - "what's new [Visual Studio]"
@@ -146,7 +146,7 @@ For more information, see the [Visual Studio Live Share for real-time code revie
 
 We're introducing a new extension that you can download to use with Visual Studio 2019. With this new extension, you can review, run, and even debug pull requests from your team without leaving Visual Studio. We support code in both GitHub and Azure DevOps repositories.
 
-   ![A screenshot of the new start window in Visual Studio 2019](media/vs-2019/pr-experience.png)
+   ![A screenshot of the new Pull Requests extension in Visual Studio 2019](media/vs-2019/pr-experience.png)
 
 For more information, see the [Code reviews using the Visual Studio Pull Requests extension](https://devblogs.microsoft.com/visualstudio/code-reviews-using-the-visual-studio-pull-requests-extension/) blog post.
 
@@ -235,9 +235,9 @@ Why send feedback to the Visual Studio team? Because we take customer feedback s
 * [Visual Studio 2019 release notes](/visualstudio/releases/2019/release-notes/)
 * [Visual Studio 2019 for Mac release notes](/visualstudio/releasenotes/vs2019-mac-relnotes/)
 * [What's new in the Visual Studio 2019 SDK](../extensibility/whats-new-visual-studio-2019-sdk.md)
-* [What's new for C++ in Visual Studio](/cpp/overview/what-s-new-for-visual-cpp-in-visual-studio.md)
-* [What's new for C# 8.0](/dotnet/csharp/whats-new/csharp-8.md)
-* [What's new in .NET Core 3.1](/dotnet/core/whats-new/dotnet-core-3-1.md)
-* [What's new in .NET Framework](/dotnet/framework/whats-new.md)
+* [What's new for C++ in Visual Studio](/cpp/overview/what-s-new-for-visual-cpp-in-visual-studio/)
+* [What's new for C# 8.0](/dotnet/csharp/whats-new/csharp-8/)
+* [What's new in .NET Core 3.1](/dotnet/core/whats-new/dotnet-core-3-1/)
+* [What's new in .NET Framework](/dotnet/framework/whats-new/)
 * [Microsoft Build conference](https://www.microsoft.com/build)
 * [Microsoft Ignite conference](https://www.microsoft.com/ignite)

mac/accessibility-ide-options.md

@@ -1,7 +1,7 @@
 ---
 title: "Set IDE accessibility options"
 description: "Introduction to setting accessibility options in Visual Studio for Mac"
-author: alanjclark
+author: heiligerdankgesang
 ms.author: dominicn
 ms.date: 09/23/2019
 ms.assetid: 87D22340-2BE6-40EE-ACFD-3CF1BA886175

mac/accessibility-keyboard.md

@@ -1,7 +1,7 @@
 ---
 title: "Keyboard navigation in Visual Studio for Mac"
 description: "Using Visual Studio for Mac with keyboard commands"
-author: alanjclark
+author: heiligerdankgesang
 ms.author: dominicn
 ms.date: 09/23/2019
 ms.assetid: EF574E49-0465-4973-BE67-286DA20B8836

mac/accessibility-macos.md

@@ -1,7 +1,7 @@
 ---
 title: "Using macOS accessibility options"
 description: "Using macOS accessibility options and features, such as high contrast, keyboard navigation, and VoiceOver"
-author: alanjclark
+author: heiligerdankgesang
 ms.author: dominicn
 ms.date: 09/23/2019
 ms.assetid: 598FC25A-6DA3-44BB-B128-AD979E9F86EA

mac/accessibility-voiceover.md

@@ -1,7 +1,8 @@
 ---
 title: "Using VoiceOver with Visual Studio for Mac"
+titleSuffix: ""
 description: "Using macOS VoiceOver navigation with Visual Studio for Mac"
-author: alanjclark
+author: heiligerdankgesang
 ms.author: dominicn
 ms.date: 09/23/2019
 ms.assetid: 590C325D-AAD0-4889-B1DB-A1090BBFBE89

mac/accessibility.md

@@ -1,7 +1,7 @@
 ---
 title: "Accessibility"
 description: "Introduction of accessibility features in Visual Studio for Mac and how they can be enabled."
-author: alanjclark
+author: heiligerdankgesang
 ms.author: dominicn
 ms.date: 09/23/2019
 ms.assetid: 2C4AAC2E-3B4A-4496-8BE0-1F5A7F81D1CA

mac/customizing-the-ide.md

@@ -1,7 +1,7 @@
 ---
 title: Customizing the IDE
 description: Visual Studio for Mac can be customized in a variety of ways, allowing users to develop apps in an environment that meets both their efficiency and aesthetic needs. This article explores the variety of ways Visual Studio for Mac can be adapted to suit your needs.
-author: alanjclark
+author: heiligerdankgesang
 ms.author: dominicn
 ms.date: 05/06/2018
 ms.assetid: F7C2A28C-0759-4E0D-A28E-B72D5AB73DB6

mac/docfx.json

@@ -79,7 +79,7 @@
       "breadcrumb_path": "~/_breadcrumb/toc.yml",
       "extendBreadcrumb": true,
       "manager": "dominicn",
-      "titleSuffix": "Visual Studio 2019 for Mac",
+      "titleSuffix": "Visual Studio for Mac",
       "ms.topic": "conceptual",
       "audience": "developer",
       "ms.prod": "visual-studio-mac",

mac/docker-multi-container.md

@@ -1,5 +1,5 @@
 ---
-title: Tutorial - Create a Multi-Container App with Docker Compose
+title: Multi-Container App with Docker Compose
 description: Learn how to manage more than one container and communicate between them in Visual Studio for Mac
 author: heiligerdankgesang
 ms.author: dominicn

mac/install-behind-a-firewall-or-proxy-server.md

@@ -1,5 +1,6 @@
 ---
-title: "Install and use Visual Studio for Mac behind a firewall or proxy server"
+title: "Install and use Visual Studio for Mac with a firewall or proxy server"
+titleSuffix: ""
 description: "This document provides a list of hosts that must be allowed in your firewall to allow Visual Studio for Mac (and its workloads, including Xamarin) to work in a corporate environment."
 ms.assetid: 79C0F1A3-0C13-4E55-A820-1138A4082B77
 author: heiligerdankgesang

mac/tutorial-aspnet-core-vsmac-extending.md

@@ -1,5 +1,5 @@
 ---
-title: "Extending an existing ASP.NET Core web application"
+title: "Extend an existing ASP.NET Core web application"
 description: This document contains video tutorials showing how to extend the eShopOnWeb sample ASP.NET Core application.
 author: sayedihashimi
 ms.author: sayedha

mac/tutorial-aspnet-core-vsmac-getting-started.md

@@ -1,5 +1,6 @@
 ---
 title: "Getting started with ASP.NET Core in Visual Studio for Mac"
+titleSuffix: ""
 description: This document contains video tutorials showing how to get start with ASP.NET Core in Visual Studio for Mac.
 author: sayedihashimi
 ms.author: sayedha