[Improvement]: Create a landing page for Copilot Metrics (#59462)

sophietheking · web-flow · commit 0e4fcb6d4854 · 2026-02-06T13:50:13.000Z
diff --git a/content/copilot/concepts/copilot-usage-metrics/copilot-metrics.md b/content/copilot/concepts/copilot-usage-metrics/copilot-metrics.md
@@ -1,7 +1,7 @@
 ---
 title: GitHub Copilot usage metrics
 shortTitle: Copilot usage metrics
-intro: 'Track how your teams are using and adopting {% data variables.product.prodname_copilot %} with detailed usage metrics.'
+intro: '{% data variables.product.prodname_copilot %} usage metrics provide visibility into how {% data variables.product.prodname_copilot %} is adopted and used across your organization, including engagement, activity, and code generation trends.'
 versions:
   feature: copilot
 topics:
@@ -15,9 +15,12 @@ redirect_from:
   - /early-access/copilot-metrics/apis/about-the-copilot-metrics-apis
   - /early-access/copilot-metrics/dashboards/about-the-copilot-metrics-dashboard
   - /early-access/copilot-metrics/apis/rest-api-endpoints-for-copilot-enterprise-and-user-usage-metrics
+  - /copilot/concepts/copilot-metrics
 category:
+  - Copilot usage metrics
   - Learn about Copilot
   - Manage Copilot for a team
+  - Get started with metrics
 ---
 
 {% data reusables.copilot.usage-metrics-preview %}
diff --git a/content/copilot/concepts/copilot-usage-metrics/index.md b/content/copilot/concepts/copilot-usage-metrics/index.md
@@ -0,0 +1,30 @@
+---
+title: GitHub Copilot usage metrics
+shortTitle: Copilot usage metrics
+intro: Track how your teams are using and adopting {% data variables.product.prodname_copilot %} with detailed usage metrics.
+versions:
+  feature: copilot
+topics:
+  - Copilot
+heroImage: /assets/images/banner-images/hero-4
+layout: bespoke-landing
+sidebarLink:
+  text: All articles
+  href: /copilot/concepts/copilot-usage-metrics
+children:
+  - /copilot-metrics
+  - /content/copilot/how-tos/administer-copilot/manage-for-enterprise/view-usage-and-adoption
+  - /content/copilot/how-tos/administer-copilot/manage-for-enterprise/view-code-generation
+  - /content/copilot/reference/copilot-usage-metrics/copilot-usage-metrics
+  - /content/copilot/reference/copilot-usage-metrics/interpret-copilot-metrics
+  - /content/copilot/reference/copilot-usage-metrics/reconciling-usage-metrics
+  - /content/copilot/reference/copilot-usage-metrics/lines-of-code-metrics
+  - /content/copilot/tutorials/roll-out-at-scale/measure-success
+includedCategories:
+  - Get started with metrics
+  - Understand metrics
+  - Reconcile and validate metrics
+  - Measure success
+  - View metrics
+  - Understand available data
+---
diff --git a/content/copilot/concepts/index.md b/content/copilot/concepts/index.md
@@ -11,6 +11,7 @@ children:
   - /chat
   - /agents
   - /spark
+  - /copilot-usage-metrics
   - /prompting
   - /context
   - /tools
@@ -21,6 +22,5 @@ children:
   - /policies
   - /mcp-management
   - /network-settings
-  - /copilot-metrics
 contentType: concepts
 ---
diff --git a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/view-code-generation.md b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/view-code-generation.md
@@ -1,7 +1,7 @@
 ---
 title: Viewing the code generation dashboard
 shortTitle: View code generation
-intro: You can use the code generation dashboard to monitor how {% data variables.product.prodname_copilot_short %} generates code across your enterprise, including activity from both users and agents.
+intro: The code generation dashboard shows how {% data variables.product.prodname_copilot_short %} generates code across your enterprise, including activity from both users and agents.
 permissions: '{% data reusables.copilot.usage-metrics-permissions %}'
 versions:
   feature: copilot
@@ -10,7 +10,9 @@ topics:
 contentType: how-tos
 allowTitleToDifferFromFilename: true
 category:
+  - Copilot usage metrics
   - Manage Copilot for a team
+  - View metrics
 ---
 
 {% data reusables.copilot.usage-metrics-preview %}
diff --git a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/view-usage-and-adoption.md b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/view-usage-and-adoption.md
@@ -1,7 +1,7 @@
 ---
 title: Viewing the Copilot usage metrics dashboard
 shortTitle: View usage and adoption
-intro: You can use the {% data variables.product.prodname_copilot_short %} usage metrics dashboard to monitor how developers across your enterprise are adopting and using {% data variables.product.prodname_copilot_short %}.
+intro: '{% data variables.product.prodname_copilot_short %} usage metrics dashboards provide a centralized view of adoption and usage across your enterprise, based on IDE telemetry from developers using {% data variables.product.prodname_copilot_short %}.'
 permissions: '{% data reusables.copilot.usage-metrics-permissions %}'
 versions:
   feature: copilot
@@ -10,7 +10,9 @@ topics:
 contentType: how-tos
 allowTitleToDifferFromFilename: true
 category:
+  - Copilot usage metrics
   - Manage Copilot for a team
+  - View metrics
 ---
 
 {% data reusables.copilot.usage-metrics-preview %}
diff --git a/content/copilot/reference/copilot-usage-metrics/copilot-usage-metrics.md b/content/copilot/reference/copilot-usage-metrics/copilot-usage-metrics.md
@@ -2,7 +2,7 @@
 title: Data available in Copilot usage metrics
 allowTitleToDifferFromFilename: true
 shortTitle: Copilot usage metrics data
-intro: 'You can display and export {% data variables.product.prodname_copilot_short %} usage metrics data in the dashboard and via APIs.'
+intro: '{% data variables.product.prodname_copilot_short %} usage metrics data is available through the dashboard and APIs, using a consistent set of fields to represent adoption, usage, and code generation activity.'
 permissions: '{% data reusables.copilot.usage-metrics-permissions %}'
 versions:
   fpt: '*'
@@ -12,7 +12,9 @@ topics:
   - Copilot
   - Enterprise
 category:
+  - Copilot usage metrics
   - Manage Copilot for a team
+  - Understand available data
 ---
 
 {% data reusables.copilot.usage-metrics-preview %}
diff --git a/content/copilot/reference/copilot-usage-metrics/interpret-copilot-metrics.md b/content/copilot/reference/copilot-usage-metrics/interpret-copilot-metrics.md
@@ -1,7 +1,7 @@
 ---
 title: Interpreting usage and adoption metrics for GitHub Copilot
 shortTitle: Interpret usage metrics
-intro: 'Evaluate trends surfaced in {% data variables.product.prodname_copilot_short %} usage metrics to enable adoption in your enterprise.'
+intro: '{% data variables.product.prodname_copilot_short %} usage and adoption metrics reveal patterns in how developers engage with {% data variables.product.prodname_copilot_short %} across your enterprise.'
 permissions: '{% data reusables.copilot.usage-metrics-permissions %}'
 versions:
   feature: copilot
@@ -13,7 +13,9 @@ redirect_from:
   - /early-access/copilot-metrics/dashboards/interpreting-the-metrics
   - /copilot/reference/interpret-copilot-metrics
 category:
+  - Copilot usage metrics
   - Manage Copilot for a team
+  - Understand metrics
 ---
 
 >[!NOTE] The {% data variables.product.prodname_copilot_short %} usage metrics dashboard is currently in {% data variables.release-phases.public_preview %} and subject to change.
diff --git a/content/copilot/reference/copilot-usage-metrics/lines-of-code-metrics.md b/content/copilot/reference/copilot-usage-metrics/lines-of-code-metrics.md
@@ -1,7 +1,7 @@
 ---
 title: Lines of Code metrics
 shortTitle: Copilot LoC metrics
-intro: Understand how Lines of Code metrics measure {% data variables.product.prodname_copilot_short %}’s output and what factors affect their coverage and accuracy.
+intro: Lines of Code metrics provide a directional measure of {% data variables.product.prodname_copilot_short %} output by quantifying the lines of code suggested, added, or deleted across completions, chat, and agent features.
 permissions: '{% data reusables.copilot.usage-metrics-permissions %}'
 versions:
   feature: copilot
@@ -13,7 +13,9 @@ topics:
 contentType: reference
 allowTitleToDifferFromFilename: true
 category:
+  - Copilot usage metrics
   - Manage Copilot for a team
+  - Understand metrics
 ---
 
 {% data reusables.copilot.usage-metrics-preview %}
diff --git a/content/copilot/reference/copilot-usage-metrics/reconciling-usage-metrics.md b/content/copilot/reference/copilot-usage-metrics/reconciling-usage-metrics.md
@@ -1,7 +1,7 @@
 ---
 title: Reconciling Copilot usage metrics across dashboards, APIs, and reports
 shortTitle: Reconciling Copilot usage metrics
-intro: Understand how {% data variables.product.prodname_copilot_short %} usage metrics differ between dashboards, APIs, and exported reports.
+intro: '{% data variables.product.prodname_copilot_short %} usage metrics are derived from the same underlying telemetry but are aggregated and presented differently across dashboards, APIs, and exported reports.'
 permissions: '{% data reusables.copilot.usage-metrics-permissions %}'
 versions:
   feature: copilot
@@ -13,7 +13,9 @@ redirect_from:
   - /early-access/copilot-metrics/dashboards/best-practices-for-correlating-usage-metrics
   - /copilot/reference/reconciling-usage-metrics
 category:
+  - Copilot usage metrics
   - Manage Copilot for a team
+  - Reconcile and validate metrics
 ---
 
 {% data reusables.copilot.usage-metrics-preview %}
diff --git a/content/copilot/tutorials/roll-out-at-scale/measure-success.md b/content/copilot/tutorials/roll-out-at-scale/measure-success.md
@@ -1,7 +1,7 @@
 ---
 title: Measuring the success of a GitHub Copilot trial
 shortTitle: Measure trial success
-intro: Learn how to use {% data variables.product.prodname_copilot_short %} usage metrics to evaluate your trial, interpret adoption and engagement results, and decide how to monitor usage going forward.
+intro: Measure the success of a {% data variables.product.prodname_copilot_short %} trial by analyzing adoption, engagement, and early usage patterns using {% data variables.product.prodname_copilot_short %} usage metrics.
 permissions: '{% data reusables.copilot.usage-metrics-permissions %}'
 versions:
   feature: copilot
@@ -10,6 +10,9 @@ topics:
   - Copilot
   - Enterprise
 allowTitleToDifferFromFilename: true
+category:
+  - Copilot usage metrics
+  - Measure success
 ---
 
 When your organization runs a {% data variables.product.prodname_copilot_short %} trial, the key to success is understanding how teams adopt and use {% data variables.product.prodname_copilot_short %}.
