Clarify some code analysis TOC entries (#2931)

Colin Robertson · web-flow · commit 5929002673d8 · 2020-06-04T17:28:37.000-06:00
* Clarify some code analysis TOC entries

* Also fix overview toc

* Also update code quality landing page
diff --git a/docs/code-quality/index.yml b/docs/code-quality/index.yml
@@ -31,8 +31,6 @@ landingContent:
         links:
           - text: Analyze C/C++ code for defects walkthrough
             url: walkthrough-analyzing-c-cpp-code-for-defects.md
-          - text: Use SAL annotations to reduce C/C++ code defects
-            url: using-sal-annotations-to-reduce-c-cpp-code-defects.md
 
   # Card
   - title: Code analysis reference
@@ -47,3 +45,31 @@ landingContent:
             url: code-analysis-for-cpp-corecheck.md
           - text: C++ code analysis warnings
             url: code-analysis-for-c-cpp-warnings.md
+
+  # Card
+  - title: Use SAL annotations to reduce defects
+    linkLists:
+      - linkListType: overview
+        links:
+          - text: Understanding SAL
+            url: understanding-sal.md
+      - linkListType: get-started
+        links:
+          - text: SAL examples
+            url: best-practices-and-examples-sal.md
+      - linkListType: how-to-guide
+        links:
+          - text: Annotate function parameters and return values
+            url: annotating-function-parameters-and-return-values.md
+          - text: Annotate function behavior
+            url: annotating-function-behavior.md
+          - text: Annotate structs and classes
+            url: annotating-structs-and-classes.md
+          - text: Annotate locking behavior
+            url: annotating-locking-behavior.md
+          - text: Specify when and where annotations apply
+            url: specifying-when-and-where-an-annotation-applies.md
+      - linkListType: reference
+        links:
+          - text: SAL annotation intrinsics
+            url: intrinsic-functions.md
diff --git a/docs/code-quality/toc.yml b/docs/code-quality/toc.yml
@@ -1,7 +1,7 @@
 - name: Code analysis documentation
   href: ../code-quality/index.yml
 - name: Overview
-  displayName: "C++ code analysis"
+  displayName: "C and C++ code analysis"
   href: ../code-quality/code-analysis-for-c-cpp-overview.md
 - name: Quickstart
   href: ../code-quality/quick-start-code-analysis-for-c-cpp.md
@@ -217,10 +217,10 @@
     href: ../code-quality/c26819.md
   - name: C26820
     href: ../code-quality/c26820.md
-- name: C/C++ warnings
+- name: C/C++ code analysis warnings
   items:
   - name: Overview
-    displayName: "C++ warnings"
+    displayName: "Code analysis warnings"
     href: ../code-quality/code-analysis-for-c-cpp-warnings.md
   - name: C1250
     href: ../code-quality/c1250.md
diff --git a/docs/overview/toc.yml b/docs/overview/toc.yml
@@ -1,4 +1,4 @@
-- name: C++ in Visual Studio
+- name: Microsoft C/C++ in Visual Studio
   expanded: false
   items: 
     - name: C++ in Visual Studio
@@ -40,7 +40,7 @@
       href: /windows/uwp/gaming/tutorial--create-your-first-uwp-directx-game
 - name: Projects and build systems
   href: ../build/projects-and-build-systems-cpp.md
-- name: Read and write C++ code in Visual Studio
+- name: Read and write code in Visual Studio
   href: ../ide/read-and-understand-code-cpp.md
 - name: Windows desktop development
   href: ../windows/overview-of-windows-programming-in-cpp.md
@@ -123,6 +123,5 @@
           href: ../mfc/mfc-and-atl.md
         - name: Parallel libraries
           href: ../parallel/
-          items: 
         - name: Data access libraries
           href: ../data/
