pull origin master

Author: gewarren

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/ca2214-do-not-call-overridable-methods-in-constructors.md

@@ -1,6 +1,6 @@
 ---
 title: "CA2214: Do not call overridable methods in constructors"
-ms.date: 11/04/2016
+ms.date: 05/29/2016
 ms.topic: reference
 f1_keywords:
   - "DoNotCallOverridableMethodsInConstructors"
@@ -33,7 +33,10 @@ The constructor of an unsealed type calls a virtual method defined in its class.
 
 ## Rule description
 
-When a virtual method is called, the actual type that executes the method is not selected until run time. When a constructor calls a virtual method, it is possible that the constructor for the instance that invokes the method has not executed.
+When a virtual method is called, the actual type that executes the method is not selected until run time. When a constructor calls a virtual method, it's possible that the constructor for the instance that invokes the method has not executed.
+
+> [!NOTE]
+> The binary analysis implementation of this rule has a different diagnostic message of "**\[Constructor name] contains a call chain that results in a call to a virtual method defined by the class. Review the following call stack for unintended consequences**". The [FxCop analyzers](install-fxcop-analyzers.md) implementation of this rule has a diagnostic message of "**Do not call overridable methods in constructors**".
 
 ## How to fix violations
 
@@ -45,7 +48,7 @@ Do not suppress a warning from this rule. The constructor should be redesigned t
 
 ## Example
 
-The following example demonstrates the effect of violating this rule. The test application creates an instance of `DerivedType`, which causes its base class (`BadlyConstructedType`) constructor to execute. `BadlyConstructedType`'s constructor incorrectly calls the virtual method `DoSomething`. As the output shows, `DerivedType.DoSomething()` executes, and does so before `DerivedType`'s constructor executes.
+The following example demonstrates the effect of violating this rule. The test application creates an instance of `DerivedType`, which causes its base class (`BadlyConstructedType`) constructor to execute. `BadlyConstructedType`'s constructor incorrectly calls the virtual method `DoSomething`. As the output shows, `DerivedType.DoSomething()` executes before `DerivedType`'s constructor executes.
 
 [!code-csharp[FxCop.Usage.CtorVirtual#1](../code-quality/codesnippet/CSharp/ca2214-do-not-call-overridable-methods-in-constructors_1.cs)]
 [!code-vb[FxCop.Usage.CtorVirtual#1](../code-quality/codesnippet/VisualBasic/ca2214-do-not-call-overridable-methods-in-constructors_1.vb)]

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