Merge pull request #1525 from gewarren/gewarren-codemetrics

Add links to Code Metrics topic

Author: Lisaco88

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

@@ -7,12 +7,12 @@ ms.suite: ""
 ms.technology: vs-ide-code-analysis
 ms.tgt_pltfrm: ""
 ms.topic: "article"
-helpviewer_keywords: 
+helpviewer_keywords:
   - "code metrics [Visual Studio]"
 author: "gewarren"
 ms.author: "gewarren"
 manager: ghogen
-ms.workload: 
+ms.workload:
   - "multiple"
 ---
 # Code metrics values
@@ -21,9 +21,11 @@ The increased complexity of modern software applications also increases the diff
 
 Developers can use Visual Studio to generate code metrics data that measure the complexity and maintainability of their managed code. Code metrics data can be generated for an entire solution or a single project.
 
+For information about how to generate code metrics data in Visual Studio, see [How to: Generate code metrics data](../code-quality/how-to-generate-code-metrics-data.md).
+
 ## Software measurements
 
-The following list shows the code metrics results that [!INCLUDE[vsprvs](../code-quality/includes/vsprvs_md.md)] calculates:
+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.
 
@@ -45,4 +47,9 @@ For more information about how Code Metrics treats anonymous methods, see [Anony
 
 Some software tools and compilers generate code that is added to a project and that the project developer either does not see or should not change. Mostly, Code Metrics ignores generated code when it calculates the metrics values. This enables the metrics values to reflect what the developer can see and change.
 
-Code generated for Windows Forms is not ignored, because it is code that the developer can see and change.
+Code generated for Windows Forms is not ignored, because it is code that the developer can see and change.
+
+## 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)

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

@@ -16,15 +16,15 @@ manager: ghogen
 ms.workload:
   - "multiple"
 ---
-# How to: Enforce Maintainable Code with a Code Analysis Check-in Policy
+# How to: Enforce maintainable code with a code analysis check-in policy
 
-Developers can use the Code Metrics tool to measure the complexity and maintainability of their code, but you cannot invoke code metrics as part of a check-in policy. However, you can enable Code Analysis rules that verify the compliance of your code with Code Metrics standards, and enforce the rules through check-in policies. For more information about code metrics, see the [Code Metrics values](../code-quality/code-metrics-values.md).
+Developers can use the Code Metrics tool to measure the complexity and maintainability of their code, but you cannot invoke Code Metrics as part of a check-in policy. However, you can enable Code Analysis rules that verify the compliance of your code with code metrics standards, and enforce the rules through check-in policies. For more information about code metrics, see [Code metrics values](../code-quality/code-metrics-values.md).
 
 You can enable the Depth of Inheritance, Class Coupling, Maintainability Index, and Complexity rules to enforce maintainable code through a Code Analysis check-in policy. All four of these rules are found under the "Maintainability Rules" category in the Code Analysis policy editor.
 
 Administrators of version control for Team Foundation can add the Code Analysis Maintainability Rules to the check-in policy requirements. These check-in policies require developers to run Code Analysis based on these rule changes before initiating a check-in.
 
-## To open the Code Analysis Policy Editor
+## To open the Code Analysis Policy editor
 
 1.In **Team Explorer**, right-click the team project, click **Team Project Settings**, and then click **Source Control**.
 
@@ -38,7 +38,7 @@ Administrators of version control for Team Foundation can add the Code Analysis
 
      The **Code Analysis Policy Editor** dialog box appears.
 
-## To enable Code Analysis Maintainability Rules
+## To enable code analysis maintainability rules
 
 1.In the **Code Analysis Policy Editor** dialog box, under **Rule Settings**, expand the **Maintainability Rules** node.
 
@@ -58,5 +58,5 @@ 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/creating-and-using-code-analysis-check-in-policies.md)
+[Code metrics values](../code-quality/code-metrics-values.md)
+[Creating and using code analysis check-in policies](../code-quality/creating-and-using-code-analysis-check-in-policies.md)

docs/code-quality/how-to-generate-code-metrics-data.md

@@ -1,20 +1,20 @@
 ---
-title: "How to generate Code Metrics data in Visual Studio | Microsoft Docs"
+title: "How to generate code metrics data in Visual Studio | Microsoft Docs"
 ms.custom: ""
 ms.date: "12/12/2017"
 ms.reviewer: ""
 ms.suite: ""
 ms.technology: vs-ide-code-analysis
 ms.tgt_pltfrm: ""
 ms.topic: "article"
-helpviewer_keywords: 
+helpviewer_keywords:
   - "code metrics data"
   - "code metrics results"
   - "code metrics [Visual Studio]"
 author: "gewarren"
 ms.author: "gewarren"
 manager: ghogen
-ms.workload: 
+ms.workload:
   - "multiple"
 ---
 # How to: Generate code metrics data
@@ -33,7 +33,7 @@ You can generate code metrics results for an entire solution or the selected pro
 
 - In the **Code Metrics Results** window, choose the **Calculate Code Metrics for Solution** button.
 
-   The results are generated and the **Code Metrics Results** window is displayed.
+The results are generated and the **Code Metrics Results** window is displayed.
 
 ## To generate code metrics results for one or more selected projects
 
@@ -45,8 +45,9 @@ You can generate code metrics results for an entire solution or the selected pro
 
 ## To view the results details
 
-- In the **Code Metrics Results** window, expand the tree in the **Hierarchy** column.
+In the **Code Metrics Results** window, expand the tree in the **Hierarchy** column.
 
 ## See also
 
-[Code Metrics values](../code-quality/code-metrics-values.md)
+- [Use the Code Metrics Results window](../code-quality/working-with-code-metrics-data.md)
+- [Code metrics values](../code-quality/code-metrics-values.md)

docs/code-quality/working-with-code-metrics-data.md

@@ -1,28 +1,28 @@
 ---
-title: "Code Metrics Results in Visual Studio | Microsoft Docs"
+title: "The Code Metrics Results window in Visual Studio | Microsoft Docs"
 ms.custom: ""
 ms.date: "12/12/2017"
 ms.reviewer: ""
 ms.suite: ""
-ms.technology: 
+ms.technology:
   - "vs-ide-code-analysis"
 ms.tgt_pltfrm: ""
 ms.topic: "article"
-f1_keywords: 
+f1_keywords:
   - "vs.codemetrics.output"
-helpviewer_keywords: 
+helpviewer_keywords:
   - "code metrics results"
   - "code metrics results window"
   - "results window, code metrics"
 author: "gewarren"
 ms.author: "gewarren"
 manager: ghogen
-ms.workload: 
+ms.workload:
   - "multiple"
 ---
-# Working with code metrics data
+# Using the Code Metrics Results window
 
-The **Code Metrics Results** window displays the data that is generated by the code metrics analysis. For more information about code metrics data values, see [Code Metrics Values](../code-quality/code-metrics-values.md).
+The **Code Metrics Results** window displays the data that is generated by the code metrics analysis. For more information about code metrics data values, see [Code metrics values](../code-quality/code-metrics-values.md).
 
 ## Displaying code metrics results
 
@@ -36,7 +36,7 @@ The **Code Metrics Results** window is displayed automatically when you generate
 
 - On the **View** menu, choose **Other Windows** > **Code Metrics Results**.
 
-   The **Code Metrics Results** window is displayed, even if it contains no results.
+The **Code Metrics Results** window is displayed, even if it contains no results.
 
 ### To view code metrics details
 
@@ -127,5 +127,5 @@ For more information about VSTS work items, see [Work items (VSTS)](/vsts/work/w
 
 ## See also
 
-[Code Metrics values](../code-quality/code-metrics-values.md)  
-[How to: Generate Code Metrics Data](../code-quality/how-to-generate-code-metrics-data.md)
+- [Code metrics values](../code-quality/code-metrics-values.md)
+- [How to: Generate code metrics data](../code-quality/how-to-generate-code-metrics-data.md)