Merge pull request #4722 from MicrosoftDocs/master

5/28/2019 AM Publish

Author: Taojunshen

docs/azure/vs-azure-tools-cloud-service-retain-a-constant-virtual-ip-address.md

@@ -1,5 +1,5 @@
 ---
-title: How to retain a constant virtual IP address for an Azure cloud service | Microsoft Docs
+title: Retain constant virtual IP address for Azure cloud service
 description: Learn how to ensure that the virtual IP address (VIP) of your Azure cloud service doesn't change.
 author: ghogen
 manager: jillfra

docs/azure/vs-azure-tools-emulator-express-debug-run.md

@@ -1,5 +1,5 @@
 ---
-title: Using Emulator Express to run and debug an Azure cloud service on a local machine | Microsoft Docs
+title: Emulator Express to run/debug Azure cloud service on local box
 description: Using Emulator Express to run and debug a cloud service on a local machine
 author: mikejo5000
 manager: jillfra

docs/azure/vs-azure-tools-migrate-publish-web-app-to-cloud-service.md

@@ -1,5 +1,5 @@
 ---
-title: How to Migrate and Publish a Web Application to an Azure Cloud Service
+title: Migrate & publish web application to Azure Cloud Service
 description: Learn how to migrate and publish your web application to an Azure cloud service by using Visual Studio
 author: ghogen
 manager: jillfra

docs/azure/vs-azure-tools-multiple-services-project-configurations.md

@@ -1,5 +1,5 @@
 ---
-title: Configuring your Azure project using multiple service configurations | Microsoft Docs
+title: Configure Azure project with multiple service configurations
 description: Learn how to configure an Azure cloud service project by changing the ServiceDefinition.csdef, ServiceConfiguration.Local.cscfg, and ServiceConfiguration.Cloud.cscfg files.
 author: ghogen
 manager: jillfra

docs/azure/vs-azure-tools-upgrade-projects-to-the-current-version-of-the-azure-tools.md

@@ -1,5 +1,5 @@
 ---
-title: How to upgrade projects to the current version of the Azure tools | Microsoft Docs
+title: Upgrade projects to current version of Azure tools
 description: Learn how to upgrade an Azure project in Visual Studio to the current version of the Azure tools
 author: ghogen
 manager: jillfra

docs/code-quality/code-metrics-values.md

@@ -22,15 +22,15 @@ For information about how to generate code metrics data in Visual Studio, see [H
 
 The following list shows the code metrics results that Visual Studio calculates:
 
-- **Maintainability Index** - Calculates an index value between 0 and 100 that represents the relative ease of maintaining the code. A high value means better maintainability. Color coded ratings can be used to quickly identify trouble spots in your code. A green rating is between 20 and 100 and indicates that the code has good maintainability. A yellow rating is between 10 and 19 and indicates that the code is moderately maintainable. A red rating is a rating between 0 and 9 and indicates low maintainability.
+- **Maintainability Index** - Calculates an index value between 0 and 100 that represents the relative ease of maintaining the code. A high value means better maintainability. Color coded ratings can be used to quickly identify trouble spots in your code. A green rating is between 20 and 100 and indicates that the code has good maintainability. A yellow rating is between 10 and 19 and indicates that the code is moderately maintainable. A red rating is a rating between 0 and 9 and indicates low maintainability. For more information, see the [Maintainability index range and meaning](https://blogs.msdn.microsoft.com/codeanalysis/2007/11/20/maintainability-index-range-and-meaning/) blog post.
 
-- **Cyclomatic Complexity** - Measures the structural complexity of the code. It is created by calculating the number of different code paths in the flow of the program. A program that has complex control flow will require more tests to achieve good code coverage and will be less maintainable.
+- **Cyclomatic Complexity** - Measures the structural complexity of the code. It is created by calculating the number of different code paths in the flow of the program. A program that has complex control flow requires more tests to achieve good code coverage and is less maintainable. For more information, see the [Uncyclopedia entry for cyclomatic complexity](https://wikipedia.org/wiki/Cyclomatic_complexity).
 
-- **Depth of Inheritance** - Indicates the number of class definitions that extend to the root of the class hierarchy. The deeper the hierarchy the more difficult it might be to understand where particular methods and fields are defined or/and redefined.
+- **Depth of Inheritance** - Indicates the number of different classes that inherit from one another, all the way back to the base class. Depth of Inheritance is similar to class coupling in that a change in a base class can affect any of its inherited classes. The higher this number, the deeper the inheritance and the higher the potential for base class modifications to result in a breaking change. For Depth of Inheritance, a low value is good and a high value is bad. 
 
-- **Class Coupling** - Measures the coupling to unique classes through parameters, local variables, return types, method calls, generic or template instantiations, base classes, interface implementations, fields defined on external types, and attribute decoration. Good software design dictates that types and methods should have high cohesion and low coupling. High coupling indicates a design that is difficult to reuse and maintain because of its many interdependencies on other types.
+- **Class Coupling** - Measures the coupling to unique classes through parameters, local variables, return types, method calls, generic or template instantiations, base classes, interface implementations, fields defined on external types, and attribute decoration. Good software design dictates that types and methods should have high cohesion and low coupling. High coupling indicates a design that is difficult to reuse and maintain because of its many interdependencies on other types. For more information, see the [Class coupling](https://blogs.msdn.microsoft.com/zainnab/2011/05/25/code-metrics-class-coupling/) blog post.
 
-- **Lines of Code** - Indicates the approximate number of lines in the code. The count is based on the IL code and is therefore not the exact number of lines in the source code file. A very high count might indicate that a type or method is trying to do too much work and should be split up. It might also indicate that the type or method might be hard to maintain.
+- **Lines of Code** - Indicates the approximate number of lines in the code. The count is based on the IL code and is therefore not the exact number of lines in the source code file. A high count might indicate that a type or method is trying to do too much work and should be split up. It might also indicate that the type or method might be hard to maintain.
 
    > [!NOTE]
    > The [command-line version](../code-quality/how-to-generate-code-metrics-data.md#command-line-code-metrics) of the code metrics tool counts actual lines of code because it analyzes the source code instead of IL.
@@ -50,4 +50,4 @@ Code generated for Windows Forms is not ignored, because it is code that the dev
 ## Next steps
 
 - [How to: Generate code metrics data](../code-quality/how-to-generate-code-metrics-data.md)
-- [Use the Code Metrics Results window](../code-quality/working-with-code-metrics-data.md)
+- [Use the Code Metrics Results window](../code-quality/working-with-code-metrics-data.md)

docs/code-quality/how-to-enable-and-disable-full-solution-analysis-for-managed-code.md

@@ -1,5 +1,5 @@
 ---
-title: "How to: Enable and Disable Full Solution Analysis for Managed Code"
+title: "Enable & disable full solution analysis for managed code"
 ms.date: 03/23/2018
 ms.topic: "conceptual"
 helpviewer_keywords:

docs/code-quality/how-to-enforce-maintainable-code-with-a-code-analysis-check-in-policy.md

@@ -1,5 +1,5 @@
 ---
-title: "How to: Enforce Maintainable Code with a Code Analysis Check-in Policy"
+title: "Use a code analysis check-in policy"
 ms.date: 11/04/2016
 ms.topic: "conceptual"
 helpviewer_keywords:
@@ -54,4 +54,4 @@ Administrators of version control for Team Foundation can add the Code Analysis
 ## See also
 
 - [Code metrics values](../code-quality/code-metrics-values.md)
-- [Creating and using code analysis check-in policies](../code-quality/how-to-create-or-update-standard-code-analysis-check-in-policies.md)
+- [Creating and using code analysis check-in policies](../code-quality/how-to-create-or-update-standard-code-analysis-check-in-policies.md)

docs/code-quality/how-to-specify-additional-code-information-by-using-analysis-assume.md

@@ -1,5 +1,5 @@
 ---
-title: "How to: Specify Additional Code Information by Using _Analysis_assume"
+title: "Use _Analysis_assume for code analysis hints"
 ms.date: 11/04/2016
 ms.topic: "conceptual"
 f1_keywords:
@@ -50,4 +50,4 @@ void test( )
 ```
 
 ## See Also
- [__assume](/cpp/intrinsics/assume)
+ [__assume](/cpp/intrinsics/assume)

docs/code-quality/how-to-synchronize-code-project-rule-sets-with-team-project-check-in-policy.md

@@ -1,5 +1,5 @@
 ---
-title: "How to: Synchronize Code Project Rule Sets with Team Project Check-in Policy"
+title: "Sync project rule sets with check-in policy"
 ms.date: 11/04/2016
 ms.topic: conceptual
 f1_keywords:
@@ -57,4 +57,4 @@ You synchronize the code analysis settings for code projects to the check-in pol
 
 6. In the **Run this rule set** list, click **\<Browse...>**.
 
-7. In the **Open** dialog box, specify the rule set file.
+7. In the **Open** dialog box, specify the rule set file.

docs/code-quality/implementing-custom-code-analysis-check-in-policies-for-managed-code.md

@@ -1,5 +1,5 @@
 ---
-title: Implementing Custom Code Analysis Check-in Policies for Managed Code
+title: Custom code analysis check-in policies for managed code
 ms.date: 11/04/2016
 ms.topic: conceptual
 f1_keywords:

docs/containers/hosting-web-apps-in-docker.md

@@ -1,5 +1,5 @@
 ---
-title: Deploy an ASP.NET Docker container to Azure Container Registry (ACR) | Microsoft Docs
+title: Deploy ASP.NET Docker container to ACR registry
 description: Learn how to use Visual Studio Container Tools to deploy an ASP.NET Core web app to a container registry
 author: ghogen
 manager: jillfra
@@ -59,4 +59,4 @@ The following steps guide you through creating a basic ASP.NET Core app that wil
 
 5. Click **Create**
 
-You can now pull the container from the registry to any host capable of running Docker images, for example [Azure Container Instances](/azure/container-instances/container-instances-tutorial-deploy-app).
+You can now pull the container from the registry to any host capable of running Docker images, for example [Azure Container Instances](/azure/container-instances/container-instances-tutorial-deploy-app).

docs/containers/tutorial-kubernetes-tools.md

@@ -21,7 +21,7 @@ To leverage this new functionality, you'll need:
 
 ::: moniker range="vs-2017"
 - The latest version of [Visual Studio 2017](https://visualstudio.microsoft.com/vs/older-downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=vs+2017+download) with the *ASP.NET and web development* workload.
-- The [Kubernetes tools for Visual Studio](https://aka.ms/get-vsk8stools), available as a separate download.
+- The [Kubernetes tools for Visual Studio](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vs-tools-for-kubernetes), available as a separate download.
 ::: moniker-end
 ::: moniker range="vs-2019"
 - [Visual Studio 2019](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=inline+link&utm_content=download+vs2019) with the *ASP.NET and web development* workload.
@@ -30,7 +30,7 @@ To leverage this new functionality, you'll need:
 ::: moniker range="vs-2017"
 - If you wish to publish to AKS from Visual Studio (*not* required for debugging in AKS using Azure Dev Spaces):
 
-    1. The [AKS publishing tools](https://aka.ms/get-vsk8spublish), available as a separate download.
+    1. The [AKS publishing tools](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vs-tools-for-kubernetes), available as a separate download.
 
     1. An Azure Kubernetes Service cluster. For more information, see
         [Creating an AKS cluster](/azure/aks/kubernetes-walkthrough-portal#create-an-aks-cluster). Be sure to [connect to the cluster](/azure/aks/kubernetes-walkthrough#connect-to-the-cluster) from your development workstation.

docs/containers/tutorial-multicontainer.md

@@ -1,5 +1,5 @@
 ---
-title: Visual Studio Container Tools multicontainer tutorial with Docker Compose and ASP.NET Core
+title: "Multicontainer tutorial using Docker Compose & ASP.NET Core"
 author: ghogen
 description: Learn how to use multiple containers with Docker Compose
 ms.author: ghogen

docs/containers/view-and-diagnose-containers.md

@@ -1,5 +1,5 @@
 ---
-title: View container logs and environment variables and access the filesystem.
+title: Container logs, environment variables, & filesystem access
 description: Describes how to improve your ability to debug and diagnose your container-based apps in Visual Studio by using a tool window  to see what's going on inside the containers that host your app.
 author: ghogen
 ms.author: ghogen

docs/cross-platform/index.md

@@ -98,7 +98,7 @@ Create native C++ apps for iOS, Android, and Windows devices with Visual Studio.
                 <div class="card">
                     <div class="cardText">
                         <h3>Platforms</h3>
-                        <p><a href="/cpp/windows/universal-windows-apps-cpp">Universal Windows Platform (UWP) documentation</a></p>
+                        <p><a href="/cpp/cppcx/universal-windows-apps-cpp">Universal Windows Platform (UWP) documentation</a></p>
                         <p><a href="https://developer.apple.com/reference">iOS API documentation</a></p>
                         <p><a href="https://developer.android.com/guide/index.html">Android API documentation</a></p>
                     </div>

docs/cross-platform/install-visual-cpp-for-cross-platform-mobile-development.md

@@ -68,7 +68,7 @@ The Visual Studio Installer for Visual Studio 2017 includes a **Mobile developme
 1. Open Visual Studio.
 
 > [!NOTE]
-> If you're using Visual Studio 2015, see [Install Visual C++ for Cross-Platform Mobile Development (Visual Studio 2015)](/cross-platform/install-visual-cpp-for-cross-platform-mobile-development?view=vs-2015)
+> If you're using Visual Studio 2015, see [Install Visual C++ for Cross-Platform Mobile Development (Visual Studio 2015)](install-visual-cpp-for-cross-platform-mobile-development.md?view=vs-2015)
 
 ## Install tools for iOS
 

docs/cross-platform/troubleshooting-and-known-issues-visual-studio-tools-for-unity.md

@@ -1,5 +1,5 @@
 ---
-title: "Troubleshooting and Known Issues (Visual Studio Tools for Unity) | Microsoft Docs"
+title: "Troubleshooting and known issues (VS Tools for Unity)"
 ms.custom: ""
 ms.date: "07/03/2018"
 ms.technology: vs-unity-tools
@@ -48,7 +48,7 @@ This should fix your issue. In case you are still experiencing the problem, run
 
 Several Unity plugins like Parse, FMOD, UMP (Universal Media Player), ZFBrowser, or Embedded Browser are using native threads. It’s an issue when a plugin ends up attaching a native thread to the runtime, which then does blocking calls to the OS. This means Unity can't interrupt that thread for the debugger (or domain reload) and hang.
 
-For FMOD, there is a workaround, you can pass `FMOD_STUDIO_INIT_SYNCHRONOUS_UPDATE` initialization [flag](https://www.fmod.org/docs/content/generated/FMOD_STUDIO_INITFLAGS.html) to disable asynchronous processing and perform all processing on the main thread.
+For FMOD, there is a workaround, you can pass `FMOD_STUDIO_INIT_SYNCHRONOUS_UPDATE` initialization [flag](https://www.fmod.com/resources/documentation-studio?version=2.0&page=https://fmod.com/resources/documentation-api?version=2.0&page=studio-api-system.html#fmod_studio_initflags) to disable asynchronous processing and perform all processing on the main thread.
 
 ## Incompatible project in Visual Studio
 

docs/cross-platform/troubleshooting-the-visual-studio-emulator-for-android.md

@@ -137,7 +137,7 @@ This topic contains information to help you resolve issues that you may experien
 
 - Make sure that minimum hardware requirements are fulfilled and that BIOS settings are correct.
 
-   The Emulator and Windows 8 Hyper-V require a 64-bit processor with Second Level Address Translation (SLAT). For Intel, you essentially need a Core i3, i5 or i7 processor (or one of many Xeons). A list of AMD chips is available [here](http://support.amd.com/en-us).
+   The Emulator and Windows 8 Hyper-V require a 64-bit processor with Second Level Address Translation (SLAT). For Intel, you essentially need a Core i3, i5 or i7 processor (or one of many Xeons). A list of AMD chips is available [here](https://www.amd.com/en/support).
 
   1. Make sure your computer meets the [system requirements](../cross-platform/system-requirements-for-the-visual-studio-emulator-for-android.md).
 

docs/data-tools/commit-in-process-edits-on-data-bound-controls-before-saving-data.md

@@ -1,5 +1,5 @@
 ---
-title: Commit in-process edits on data-bound controls before saving data
+title: Commit in-process edits on data-bound controls before saving
 ms.date: 11/04/2016
 ms.topic: conceptual
 dev_langs:

docs/data-tools/how-to-assign-stored-procedures-to-perform-updates-inserts-and-deletes-o-r-designer.md

@@ -1,5 +1,5 @@
 ---
-title: Use stored procedures to perform update, insert, and delete in Linq to SQL O/R Designer
+title: "Use stored procedures in LINQ to SQL to update data (O/R Designer)"
 ms.date: 11/04/2016
 ms.topic: conceptual
 ms.assetid: e88224ab-ff61-4a3a-b6b8-6f3694546cac
@@ -62,4 +62,4 @@ To revert to using the default runtime logic for updates, click the ellipsis nex
 - [LINQ to SQL tools in Visual Studio](../data-tools/linq-to-sql-tools-in-visual-studio2.md)
 - [DataContext methods](../data-tools/datacontext-methods-o-r-designer.md)
 - [LINQ to SQL (.NET Framework)](/dotnet/framework/data/adonet/sql/linq/index)
-- [Insert, update, and delete operations (.NET Framework)](/dotnet/framework/data/adonet/sql/linq/insert-update-and-delete-operations)
+- [Insert, update, and delete operations (.NET Framework)](/dotnet/framework/data/adonet/sql/linq/insert-update-and-delete-operations)

docs/data-tools/how-to-change-the-return-type-of-a-datacontext-method-o-r-designer.md

@@ -1,5 +1,5 @@
 ---
-title: "How to: Change the return type of a DataContext method (O-R Designer)"
+title: "Change return type of DataContext method (O-R Designer)"
 ms.date: 11/04/2016
 ms.topic: conceptual
 ms.assetid: c5b66bff-6dbb-43c0-bffa-317133ca5b9e

docs/data-tools/how-to-create-an-association-relationship-between-linq-to-sql-classes-o-r-designer.md

@@ -1,5 +1,5 @@
 ---
-title: How to create an relationship between LINQ to SQL classes using O/R Designer
+title: Relationships between LINQ to SQL classes (O/R Designer)
 ms.date: 11/04/2016
 ms.topic: conceptual
 ms.assetid: 56133e65-81f3-44c3-bc28-ffdd0671a0d2
@@ -46,4 +46,4 @@ After you create an association, when you select the association in the **O/R De
 - [Walkthrough: Creating LINQ to SQL classes](how-to-create-linq-to-sql-classes-mapped-to-tables-and-views-o-r-designer.md)
 - [LINQ to SQL](/dotnet/framework/data/adonet/sql/linq/index)
 - [DataContext methods (O/R Designer)](../data-tools/datacontext-methods-o-r-designer.md)
-- [How to: Represent primary keys](/dotnet/framework/data/adonet/sql/linq/how-to-represent-primary-keys)
+- [How to: Represent primary keys](/dotnet/framework/data/adonet/sql/linq/how-to-represent-primary-keys)

docs/data-tools/how-to-create-datacontext-methods-mapped-to-stored-procedures-and-functions-o-r-designer.md

@@ -1,5 +1,5 @@
 ---
-title: "How to: Create DataContext methods mapped to stored procedures and functions (O-R Designer)"
+title: "Map DataContext methods to sprocs and functions (O-R Designer)"
 ms.date: 11/04/2016
 ms.topic: conceptual
 ms.assetid: e7ca32f1-50b3-48af-ad92-ceafd749296a
@@ -51,4 +51,4 @@ You can create <xref:System.Data.Linq.DataContext> methods by dragging stored pr
 - [Walkthrough: Creating LINQ to SQL classes](how-to-create-linq-to-sql-classes-mapped-to-tables-and-views-o-r-designer.md)
 - [LINQ to SQL](/dotnet/framework/data/adonet/sql/linq/index)
 - [Introduction to LINQ in Visual Basic](/dotnet/visual-basic/programming-guide/language-features/linq/introduction-to-linq)
-- [LINQ in C#](/dotnet/csharp/linq/linq-in-csharp)
+- [LINQ in C#](/dotnet/csharp/linq/linq-in-csharp)

docs/data-tools/how-to-create-linq-to-sql-classes-mapped-to-tables-and-views-o-r-designer.md

@@ -1,5 +1,5 @@
 ---
-title: "How to: Create LINQ to SQL classes mapped to tables and views (O-R Designer)"
+title: "Map LINQ to SQL classes to tables/views (O-R Designer)"
 ms.date: 11/04/2016
 ms.topic: conceptual
 ms.assetid: 0fb78bbc-7a78-4ab4-b32f-85ece912e660
@@ -63,4 +63,4 @@ After you create entity classes by using the **O/R Designer**, you can create an
 - [How to: Create DataContext methods mapped to stored procedures and functions (O/R Designer)](../data-tools/how-to-create-datacontext-methods-mapped-to-stored-procedures-and-functions-o-r-designer.md)
 - [The LINQ to SQL object model](/dotnet/framework/data/adonet/sql/linq/the-linq-to-sql-object-model)
 - [Walkthrough: Customizing the insert, update, and delete behavior of entity classes](../data-tools/walkthrough-customizing-the-insert-update-and-delete-behavior-of-entity-classes.md)
-- [How to: Create an association (relationship) between LINQ to SQL classes (O/R Designer)](../data-tools/how-to-create-an-association-relationship-between-linq-to-sql-classes-o-r-designer.md)
+- [How to: Create an association (relationship) between LINQ to SQL classes (O/R Designer)](../data-tools/how-to-create-an-association-relationship-between-linq-to-sql-classes-o-r-designer.md)