From 223b214cdd20f41709140d8c97cccd49e3a8d720 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Thu, 4 Sep 2025 11:18:30 -0700
Subject: [PATCH 01/19] update analytics intro

---
 guides/analytics.mdx | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/guides/analytics.mdx b/guides/analytics.mdx
index e48d623db..deb3e15a8 100644
--- a/guides/analytics.mdx
+++ b/guides/analytics.mdx
@@ -14,7 +14,11 @@ Use the range selector to adjust the time period for displayed data.
 
 ## Analytics tabs
 
-The analytics dashboard has three main sections:
+The analytics dashboard has three sections:
+
+- **Overview**: View traffic and other high-level insights about your docs.
+- **Feedback**: Monitor user satisfaction through voting data and written feedback.
+- **Search**: Understand how users search within your documentation.
 
 ### Overview
 View traffic and other high-level insights about your docs.
@@ -26,6 +30,11 @@ View traffic and other high-level insights about your docs.
 - **Referrers**: Top traffic sources directing users to your docs.
 
 ### Feedback
+
+<Info>
+To collect and view feedback, you must first enable feedback from the [Add-ons](https://dashboard.mintlify.com/products/addons) page in your dashboard.
+</Info>
+
 Monitor user satisfaction through voting data:
 
 - **Liked by viewers**: Pages with the most positive feedback (thumbs up votes).

From ea3bfc296630c9d23f6f9aa92d979b495a7ca5d8 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Thu, 4 Sep 2025 11:21:35 -0700
Subject: [PATCH 02/19] update overview intro

---
 guides/analytics.mdx | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/guides/analytics.mdx b/guides/analytics.mdx
index deb3e15a8..71bc3a1fd 100644
--- a/guides/analytics.mdx
+++ b/guides/analytics.mdx
@@ -21,7 +21,8 @@ The analytics dashboard has three sections:
 - **Search**: Understand how users search within your documentation.
 
 ### Overview
-View traffic and other high-level insights about your docs.
+
+The Overview section shows how many people have visited your docs, what pages are most popular, and where users are coming from. You can use this information to identify which pages are most valuable to your users and pay attention to trends over time.
 
 - **Visitors**: Unique visitors.
 - **Views**: Total page views.

From 7dbdfdf3bca712fabc6c887e070e4977a9d07a6a Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Thu, 4 Sep 2025 11:34:45 -0700
Subject: [PATCH 03/19] update feedback section

---
 guides/analytics.mdx | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/guides/analytics.mdx b/guides/analytics.mdx
index 71bc3a1fd..50b3c0340 100644
--- a/guides/analytics.mdx
+++ b/guides/analytics.mdx
@@ -33,15 +33,22 @@ The Overview section shows how many people have visited your docs, what pages ar
 ### Feedback
 
 <Info>
-To collect and view feedback, you must first enable feedback from the [Add-ons](https://dashboard.mintlify.com/products/addons) page in your dashboard.
+  To collect and view feedback, you must first enable feedback from the [Add-ons](https://dashboard.mintlify.com/products/addons) page in your dashboard.
 </Info>
 
-Monitor user satisfaction through voting data:
+The Feedback section displays how many thumbs up and thumbs down votes your docs have received and any feedback that users have provided.
+
+If you have enabled **Thumbs rating** feedback, the Feedback section will display:
 
 - **Liked by viewers**: Pages with the most positive feedback (thumbs up votes).
 - **Needs improvement**: Pages with the most negative feedback (thumbs down votes).
 
-To view feedback data, you must first enable feedback from the [Add-ons](https://dashboard.mintlify.com/products/addons) page in your dashboard.
+If you have enabled **Contextual feedback** and **Code snippet** feedback, the Feedback section will display:
+
+- **Context**: Feedback that users have provided for specific pages, including thumps up or down ratings, reasons for the ratings, and any additional comments.
+- **Code**: Feedback that users have provided for specific code snippets.
+
+For Context and Code feedback, you can select the status beside a piece of feedback to mark it as Pending, In Progress, Resolved, or Dismissed.
 
 ### Search
 Understand how users search within your documentation.

From ee0e91032da7256c349270836cfcdac70ce0db7c Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Thu, 4 Sep 2025 11:37:23 -0700
Subject: [PATCH 04/19] update search intro

---
 guides/analytics.mdx | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/guides/analytics.mdx b/guides/analytics.mdx
index 50b3c0340..0c9b909e2 100644
--- a/guides/analytics.mdx
+++ b/guides/analytics.mdx
@@ -36,7 +36,7 @@ The Overview section shows how many people have visited your docs, what pages ar
   To collect and view feedback, you must first enable feedback from the [Add-ons](https://dashboard.mintlify.com/products/addons) page in your dashboard.
 </Info>
 
-The Feedback section displays how many thumbs up and thumbs down votes your docs have received and any feedback that users have provided.
+The Feedback section displays how many thumbs up and thumbs down votes your docs have received and any feedback that users have provided. You can use this information to discover user needs and make improvements to your docs.
 
 If you have enabled **Thumbs rating** feedback, the Feedback section will display:
 
@@ -51,7 +51,7 @@ If you have enabled **Contextual feedback** and **Code snippet** feedback, the F
 For Context and Code feedback, you can select the status beside a piece of feedback to mark it as Pending, In Progress, Resolved, or Dismissed.
 
 ### Search
-Understand how users search within your documentation.
+The Search section shows search behavior on your docs site. You can use this information to understand what users are searching for and find topics that need to be updated or added.
 
 - **Total queries**: Search volume.
 - **Top searches**: Most-searched terms.

From b2552da53ae84f4baa80dc238e55518176170c70 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Tue, 16 Sep 2025 10:02:28 -0700
Subject: [PATCH 05/19] create Analytics dashboard group

---
 docs.json | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/docs.json b/docs.json
index ac3b52032..89e8c96f0 100644
--- a/docs.json
+++ b/docs.json
@@ -136,7 +136,13 @@
             "group": "Guides",
             "pages": [
               "guides/migration",
-              "guides/analytics",
+              {
+                "group": "Analytics dashboard",
+                "icon": "chart-line",
+                "pages": [
+                  "guides/analytics"
+                ]
+              },
               "react-components",
               "settings/custom-scripts",
               "settings/seo",

From 5c2ee926288d0813fbd180da30c1aa5201af622f Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Tue, 16 Sep 2025 10:03:50 -0700
Subject: [PATCH 06/19] create new analytics pages

---
 analytics/feedback.mdx       | 0
 analytics/improving-docs.mdx | 0
 analytics/overview.mdx       | 0
 analytics/search.mdx         | 0
 4 files changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 analytics/feedback.mdx
 create mode 100644 analytics/improving-docs.mdx
 create mode 100644 analytics/overview.mdx
 create mode 100644 analytics/search.mdx

diff --git a/analytics/feedback.mdx b/analytics/feedback.mdx
new file mode 100644
index 000000000..e69de29bb
diff --git a/analytics/improving-docs.mdx b/analytics/improving-docs.mdx
new file mode 100644
index 000000000..e69de29bb
diff --git a/analytics/overview.mdx b/analytics/overview.mdx
new file mode 100644
index 000000000..e69de29bb
diff --git a/analytics/search.mdx b/analytics/search.mdx
new file mode 100644
index 000000000..e69de29bb

From a5f88e03463c1797a5dd86c578830b1851295b77 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Tue, 16 Sep 2025 10:04:44 -0700
Subject: [PATCH 07/19] update docs.json with new pages

---
 docs.json | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/docs.json b/docs.json
index 89e8c96f0..6b9998aad 100644
--- a/docs.json
+++ b/docs.json
@@ -140,7 +140,10 @@
                 "group": "Analytics dashboard",
                 "icon": "chart-line",
                 "pages": [
-                  "guides/analytics"
+                  "analytics/overview",
+                  "analytics/feedback",
+                  "analytics/search",
+                  "analytics/improving-docs"
                 ]
               },
               "react-components",
@@ -537,6 +540,10 @@
     {
       "source": "editor",
       "destination": "editor/getting-started"
+    },
+    {
+      "source": "guides/analytics",
+      "destination": "analytics/overview"
     }
   ],
   "integrations": {

From 789ecaf7b800ffc1fe64076d000afe923041482a Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Tue, 16 Sep 2025 10:07:26 -0700
Subject: [PATCH 08/19] delete guides/analytics

---
 analytics/feedback.mdx       | 24 +++++++++++++
 analytics/improving-docs.mdx | 15 ++++++++
 analytics/overview.mdx       | 30 ++++++++++++++++
 analytics/search.mdx         | 21 +++++++++++
 guides/analytics.mdx         | 68 ------------------------------------
 5 files changed, 90 insertions(+), 68 deletions(-)
 delete mode 100644 guides/analytics.mdx

diff --git a/analytics/feedback.mdx b/analytics/feedback.mdx
index e69de29bb..c46ad18da 100644
--- a/analytics/feedback.mdx
+++ b/analytics/feedback.mdx
@@ -0,0 +1,24 @@
+---
+title: "Feedback"
+description: "TODO: See feedback from your docs"
+---
+
+### Feedback
+
+<Info>
+  To collect and view feedback, you must first enable feedback from the [Add-ons](https://dashboard.mintlify.com/products/addons) page in your dashboard.
+</Info>
+
+The Feedback section displays quantitative thumbs up and thumbs down votes your docs have received and any qualitative feedback that users have provided. You can use this information to discover user needs and make improvements to your docs.
+
+If you have enabled **Thumbs rating** feedback, the Feedback section will display:
+
+- **Liked by viewers**: Pages with the most positive feedback (thumbs up votes).
+- **Needs improvement**: Pages with the most negative feedback (thumbs down votes).
+
+If you have enabled **Contextual feedback** and **Code snippet** feedback, the Feedback section will display:
+
+- **Context**: Feedback that users have provided for specific pages, including thumps up or down ratings, reasons for the ratings, and any additional comments.
+- **Code**: Feedback that users have provided for specific code snippets.
+
+For Context and Code feedback, you can select the status beside a piece of feedback to mark it as Pending, In Progress, Resolved, or Dismissed.
\ No newline at end of file
diff --git a/analytics/improving-docs.mdx b/analytics/improving-docs.mdx
index e69de29bb..adb6bdf26 100644
--- a/analytics/improving-docs.mdx
+++ b/analytics/improving-docs.mdx
@@ -0,0 +1,15 @@
+---
+title: "Improving docs"
+description: "TODO: See how to improve your docs with analytics"
+---
+
+
+## Improving your docs with analytics
+
+Use your analytics to enhance the user experience of your docs:
+
+**Review popular content**: Ensure your most-visited pages contain current, accurate information and consider expanding successful topics.
+
+**Address feedback concerns**: Investigate pages with negative feedback to identify and resolve user pain points.
+
+**Optimize for search**: Review top search queries so that relevant pages are discoverable and up-to-date. Pay attention to low-confidence searches that might indicate content gaps.
diff --git a/analytics/overview.mdx b/analytics/overview.mdx
index e69de29bb..53f440821 100644
--- a/analytics/overview.mdx
+++ b/analytics/overview.mdx
@@ -0,0 +1,30 @@
+---
+title: "Overview"
+description: "See information about your docs' performance in your dashboard"
+---
+
+The analytics page provides insights into how your documentation is performing, helping you identify improvement opportunities and track changes over time.
+
+## Accessing analytics
+
+Navigate to the **Analytics** tab in your [dashboard](https://dashboard.mintlify.com/products/analytics).
+
+Use the range selector to adjust the time period for displayed data.
+
+## Analytics tabs
+
+The analytics dashboard has three sections:
+
+- **Overview**: View traffic and other high-level insights about your docs.
+- **Feedback**: Monitor user satisfaction through voting data and written feedback.
+- **Search**: Understand how users search within your documentation.
+
+### Overview
+
+The Overview section shows how many people have visited your docs, what pages are most popular, and where users are coming from. You can use this information to identify which pages are most valuable to your users and pay attention to trends over time.
+
+- **Visitors**: Unique visitors.
+- **Views**: Total page views.
+- **Actions**: Combined count of API calls, navbar link clicks, and CTA button clicks.
+- **Popular Pages**: Most-visited pages with view counts.
+- **Referrers**: Top traffic sources directing users to your docs.
diff --git a/analytics/search.mdx b/analytics/search.mdx
index e69de29bb..fa8ba6344 100644
--- a/analytics/search.mdx
+++ b/analytics/search.mdx
@@ -0,0 +1,21 @@
+---
+title: "Search"
+description: "TODO: See search analytics for your docs"
+---
+
+### Search
+
+The Search section displays analytics about how users search within your documentation. You can use this information to identify popular search queries and improve the discoverability of your docs.
+
+### Total queries
+
+The Total queries section displays the total number of searches performed within your documentation.
+
+
+
+### Search
+The Search section shows search behavior on your docs site. You can use this information to understand what users are searching for and find topics that need to be updated or added.
+
+- **Total queries**: Search volume.
+- **Top searches**: Most-searched terms.
+- **Low-confidence searches**: Queries that may not have found relevant results.
diff --git a/guides/analytics.mdx b/guides/analytics.mdx
deleted file mode 100644
index 0c9b909e2..000000000
--- a/guides/analytics.mdx
+++ /dev/null
@@ -1,68 +0,0 @@
----
-title: "Analytics"
-description: "See information about your docs' performance in your dashboard"
-icon: "chart-line"
----
-
-The analytics page provides insights into how your documentation is performing, helping you identify improvement opportunities and track changes over time.
-
-## Accessing analytics
-
-Navigate to the **Analytics** tab in your [dashboard](https://dashboard.mintlify.com/products/analytics).
-
-Use the range selector to adjust the time period for displayed data.
-
-## Analytics tabs
-
-The analytics dashboard has three sections:
-
-- **Overview**: View traffic and other high-level insights about your docs.
-- **Feedback**: Monitor user satisfaction through voting data and written feedback.
-- **Search**: Understand how users search within your documentation.
-
-### Overview
-
-The Overview section shows how many people have visited your docs, what pages are most popular, and where users are coming from. You can use this information to identify which pages are most valuable to your users and pay attention to trends over time.
-
-- **Visitors**: Unique visitors.
-- **Views**: Total page views.
-- **Actions**: Combined count of API calls, navbar link clicks, and CTA button clicks.
-- **Popular Pages**: Most-visited pages with view counts.
-- **Referrers**: Top traffic sources directing users to your docs.
-
-### Feedback
-
-<Info>
-  To collect and view feedback, you must first enable feedback from the [Add-ons](https://dashboard.mintlify.com/products/addons) page in your dashboard.
-</Info>
-
-The Feedback section displays how many thumbs up and thumbs down votes your docs have received and any feedback that users have provided. You can use this information to discover user needs and make improvements to your docs.
-
-If you have enabled **Thumbs rating** feedback, the Feedback section will display:
-
-- **Liked by viewers**: Pages with the most positive feedback (thumbs up votes).
-- **Needs improvement**: Pages with the most negative feedback (thumbs down votes).
-
-If you have enabled **Contextual feedback** and **Code snippet** feedback, the Feedback section will display:
-
-- **Context**: Feedback that users have provided for specific pages, including thumps up or down ratings, reasons for the ratings, and any additional comments.
-- **Code**: Feedback that users have provided for specific code snippets.
-
-For Context and Code feedback, you can select the status beside a piece of feedback to mark it as Pending, In Progress, Resolved, or Dismissed.
-
-### Search
-The Search section shows search behavior on your docs site. You can use this information to understand what users are searching for and find topics that need to be updated or added.
-
-- **Total queries**: Search volume.
-- **Top searches**: Most-searched terms.
-- **Low-confidence searches**: Queries that may not have found relevant results.
-
-## Improving your docs with analytics
-
-Use your analytics to enhance the user experience of your docs:
-
-**Review popular content**: Ensure your most-visited pages contain current, accurate information and consider expanding successful topics.
-
-**Address feedback concerns**: Investigate pages with negative feedback to identify and resolve user pain points.
-
-**Optimize for search**: Review top search queries so that relevant pages are discoverable and up-to-date. Pay attention to low-confidence searches that might indicate content gaps.

From 10aadd9eebf27676eb06873add4159325137d1a8 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Tue, 16 Sep 2025 10:16:13 -0700
Subject: [PATCH 09/19] update overview

---
 analytics/overview.mdx | 20 ++++----------------
 1 file changed, 4 insertions(+), 16 deletions(-)

diff --git a/analytics/overview.mdx b/analytics/overview.mdx
index 53f440821..1a5fdd94d 100644
--- a/analytics/overview.mdx
+++ b/analytics/overview.mdx
@@ -1,27 +1,15 @@
 ---
 title: "Overview"
-description: "See information about your docs' performance in your dashboard"
+description: "View traffic and high-level insights about your documentation performance"
 ---
 
-The analytics page provides insights into how your documentation is performing, helping you identify improvement opportunities and track changes over time.
+The Overview tab shows how many people have visited your docs, what pages are most popular, and where users are coming from. Use this information to identify which pages are most valuable to your users and track trends over time.
 
-## Accessing analytics
-
-Navigate to the **Analytics** tab in your [dashboard](https://dashboard.mintlify.com/products/analytics).
+Access the Overview metrics by navigating to the **Analytics** page in your [dashboard](https://dashboard.mintlify.com/products/analytics).
 
 Use the range selector to adjust the time period for displayed data.
 
-## Analytics tabs
-
-The analytics dashboard has three sections:
-
-- **Overview**: View traffic and other high-level insights about your docs.
-- **Feedback**: Monitor user satisfaction through voting data and written feedback.
-- **Search**: Understand how users search within your documentation.
-
-### Overview
-
-The Overview section shows how many people have visited your docs, what pages are most popular, and where users are coming from. You can use this information to identify which pages are most valuable to your users and pay attention to trends over time.
+## Metrics
 
 - **Visitors**: Unique visitors.
 - **Views**: Total page views.

From 1248cb7610827a09cdc9d1c82b605fb4b0fa1b4e Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Tue, 16 Sep 2025 10:25:10 -0700
Subject: [PATCH 10/19] update search

---
 analytics/search.mdx | 23 +++++++++++------------
 1 file changed, 11 insertions(+), 12 deletions(-)

diff --git a/analytics/search.mdx b/analytics/search.mdx
index fa8ba6344..1851ea19d 100644
--- a/analytics/search.mdx
+++ b/analytics/search.mdx
@@ -1,21 +1,20 @@
 ---
 title: "Search"
-description: "TODO: See search analytics for your docs"
+description: "Understand how users search within your documentation"
 ---
 
-### Search
+The Search tab shows search behavior on your docs site. Use this information to understand what users are searching for and find topics that need to be updated or added.
 
-The Search section displays analytics about how users search within your documentation. You can use this information to identify popular search queries and improve the discoverability of your docs.
+## Search metrics
 
-### Total queries
+- **Total queries**: Search volume
+- **Top searches**: Most-searched terms
+- **Low-confidence searches**: Queries that may not have found relevant results
 
-The Total queries section displays the total number of searches performed within your documentation.
+## Using search data
 
+Review your search analytics to:
 
-
-### Search
-The Search section shows search behavior on your docs site. You can use this information to understand what users are searching for and find topics that need to be updated or added.
-
-- **Total queries**: Search volume.
-- **Top searches**: Most-searched terms.
-- **Low-confidence searches**: Queries that may not have found relevant results.
+- **Identify popular topics**: Use top searches to understand what content is most important to your users
+- **Find content gaps**: Low-confidence searches may indicate missing documentation or topics that need better coverage
+- **Improve discoverability**: Ensure that pages matching popular search terms are easy to find and well-organized

From e75ed8b648e3e0c49aa6ac5c2e7b9f9ace0f492e Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Tue, 16 Sep 2025 10:27:13 -0700
Subject: [PATCH 11/19] update improving docs

---
 analytics/improving-docs.mdx | 29 ++++++++++++++++++++++-------
 1 file changed, 22 insertions(+), 7 deletions(-)

diff --git a/analytics/improving-docs.mdx b/analytics/improving-docs.mdx
index adb6bdf26..10d084369 100644
--- a/analytics/improving-docs.mdx
+++ b/analytics/improving-docs.mdx
@@ -1,15 +1,30 @@
 ---
-title: "Improving docs"
-description: "TODO: See how to improve your docs with analytics"
+title: "Improving your docs"
+description: "Use analytics data to make your documentation better"
 ---
 
+Use your analytics data to enhance the user experience of your docs and identify improvement opportunities.
 
-## Improving your docs with analytics
-
-Use your analytics to enhance the user experience of your docs:
+## Use overview metrics
 
 **Review popular content**: Ensure your most-visited pages contain current, accurate information and consider expanding successful topics.
 
-**Address feedback concerns**: Investigate pages with negative feedback to identify and resolve user pain points.
+**Monitor traffic patterns**: Track changes in visitor counts and page views to understand the impact of updates or new content.
+
+**Analyze referrer sources**: Understand how users find your docs to optimize external linking and SEO.
+
+## Act on feedback data
+
+**Address negative feedback**: Investigate pages with poor ratings to identify and resolve user pain points.
+
+**Celebrate positive feedback**: Use highly-rated pages as examples of effective documentation patterns.
+
+**Track feedback trends**: Monitor changes in satisfaction over time, especially after making updates.
+
+## Optimize with search data
+
+**Improve content discoverability**: Review top search queries to ensure relevant pages are easy to find and well-organized.
+
+**Fill content gaps**: Pay attention to low-confidence searches that might indicate missing documentation or topics that need better coverage.
 
-**Optimize for search**: Review top search queries so that relevant pages are discoverable and up-to-date. Pay attention to low-confidence searches that might indicate content gaps.
+**Update popular content**: Ensure pages that match frequent search terms are current and comprehensive.

From 009b1fe99d39f480ce55d128b4298236382e52ba Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Tue, 16 Sep 2025 10:46:07 -0700
Subject: [PATCH 12/19] add link to dashboard

---
 analytics/search.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/analytics/search.mdx b/analytics/search.mdx
index 1851ea19d..3c3bbcc05 100644
--- a/analytics/search.mdx
+++ b/analytics/search.mdx
@@ -5,6 +5,8 @@ description: "Understand how users search within your documentation"
 
 The Search tab shows search behavior on your docs site. Use this information to understand what users are searching for and find topics that need to be updated or added.
 
+Access the Search metrics by navigating to the **Analytics** page in your [dashboard](https://dashboard.mintlify.com/products/analytics).
+
 ## Search metrics
 
 - **Total queries**: Search volume

From 4e2852696ea578d1d0faa81396882d20331823a2 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Tue, 16 Sep 2025 10:55:09 -0700
Subject: [PATCH 13/19] polish overview

---
 analytics/overview.mdx | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/analytics/overview.mdx b/analytics/overview.mdx
index 1a5fdd94d..86536f864 100644
--- a/analytics/overview.mdx
+++ b/analytics/overview.mdx
@@ -1,18 +1,18 @@
 ---
 title: "Overview"
-description: "View traffic and high-level insights about your documentation performance"
+description: "View traffic and high-level insights about your documentation"
 ---
 
 The Overview tab shows how many people have visited your docs, what pages are most popular, and where users are coming from. Use this information to identify which pages are most valuable to your users and track trends over time.
 
 Access the Overview metrics by navigating to the **Analytics** page in your [dashboard](https://dashboard.mintlify.com/products/analytics).
 
-Use the range selector to adjust the time period for displayed data.
-
 ## Metrics
 
-- **Visitors**: Unique visitors.
-- **Views**: Total page views.
-- **Actions**: Combined count of API calls, navbar link clicks, and CTA button clicks.
-- **Popular Pages**: Most-visited pages with view counts.
-- **Referrers**: Top traffic sources directing users to your docs.
+Use the range selector to adjust the time period for displayed data. Select visitors, views, or actions to display a line graph showing trends over the selected time period.
+
+- **Visitors**: Unique visitors
+- **Views**: Total page views
+- **Actions**: Combined count of API calls, navbar link clicks, and CTA button clicks
+- **Popular Pages**: Paths to the most-visited pages and their view counts
+- **Referrers**: Top traffic sources directing users to your docs

From 834ac8c15a8b60db470ce43fedbe6fc1f357ea82 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Tue, 16 Sep 2025 10:56:44 -0700
Subject: [PATCH 14/19] fix casing

---
 analytics/overview.mdx | 4 ++--
 analytics/search.mdx   | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/analytics/overview.mdx b/analytics/overview.mdx
index 86536f864..7e8e4f6f9 100644
--- a/analytics/overview.mdx
+++ b/analytics/overview.mdx
@@ -3,9 +3,9 @@ title: "Overview"
 description: "View traffic and high-level insights about your documentation"
 ---
 
-The Overview tab shows how many people have visited your docs, what pages are most popular, and where users are coming from. Use this information to identify which pages are most valuable to your users and track trends over time.
+The overview tab shows how many people have visited your docs, what pages are most popular, and where users are coming from. Use this information to identify which pages are most valuable to your users and track trends over time.
 
-Access the Overview metrics by navigating to the **Analytics** page in your [dashboard](https://dashboard.mintlify.com/products/analytics).
+Access the overview metrics by navigating to the **Analytics** page in your [dashboard](https://dashboard.mintlify.com/products/analytics).
 
 ## Metrics
 
diff --git a/analytics/search.mdx b/analytics/search.mdx
index 3c3bbcc05..2a161295e 100644
--- a/analytics/search.mdx
+++ b/analytics/search.mdx
@@ -3,9 +3,9 @@ title: "Search"
 description: "Understand how users search within your documentation"
 ---
 
-The Search tab shows search behavior on your docs site. Use this information to understand what users are searching for and find topics that need to be updated or added.
+The search tab shows search behavior on your docs site. Use this information to understand what users are searching for and find topics that need to be updated or added.
 
-Access the Search metrics by navigating to the **Analytics** page in your [dashboard](https://dashboard.mintlify.com/products/analytics).
+Access the search metrics by navigating to the **Analytics** page in your [dashboard](https://dashboard.mintlify.com/products/analytics).
 
 ## Search metrics
 

From d49bfd310c2f7ef33092e64e4c613b3c4e700cef Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Tue, 16 Sep 2025 11:06:30 -0700
Subject: [PATCH 15/19] polish search

---
 analytics/overview.mdx |  7 +++++++
 analytics/search.mdx   | 14 ++++++++------
 2 files changed, 15 insertions(+), 6 deletions(-)

diff --git a/analytics/overview.mdx b/analytics/overview.mdx
index 7e8e4f6f9..25f9e7b77 100644
--- a/analytics/overview.mdx
+++ b/analytics/overview.mdx
@@ -16,3 +16,10 @@ Use the range selector to adjust the time period for displayed data. Select visi
 - **Actions**: Combined count of API calls, navbar link clicks, and CTA button clicks
 - **Popular Pages**: Paths to the most-visited pages and their view counts
 - **Referrers**: Top traffic sources directing users to your docs
+
+## Using overview data
+
+Review your overview analytics to:
+
+- **Identify popular pages**: Use popular pages to understand what content is most important to your users so that you can make sure it is up to date and comprehensive.
+- **Track traffic trends**: Monitor changes in traffic to understand the impact of updates or new content.
diff --git a/analytics/search.mdx b/analytics/search.mdx
index 2a161295e..ba60d458b 100644
--- a/analytics/search.mdx
+++ b/analytics/search.mdx
@@ -3,20 +3,22 @@ title: "Search"
 description: "Understand how users search within your documentation"
 ---
 
-The search tab shows search behavior on your docs site. Use this information to understand what users are searching for and find topics that need to be updated or added.
+Use the data on the search tab to understand what users are searching for and identify topics that need to be updated or expanded.
 
-Access the search metrics by navigating to the **Analytics** page in your [dashboard](https://dashboard.mintlify.com/products/analytics).
+Access your search metrics by navigating to the **Analytics** page in your [dashboard](https://dashboard.mintlify.com/products/analytics).
 
 ## Search metrics
 
+Use the range selector to adjust the time period for displayed data.
+
 - **Total queries**: Search volume
 - **Top searches**: Most-searched terms
-- **Low-confidence searches**: Queries that may not have found relevant results
+- **Low-confidence searches**: Queries that may not have returned relevant results
 
 ## Using search data
 
 Review your search analytics to:
 
-- **Identify popular topics**: Use top searches to understand what content is most important to your users
-- **Find content gaps**: Low-confidence searches may indicate missing documentation or topics that need better coverage
-- **Improve discoverability**: Ensure that pages matching popular search terms are easy to find and well-organized
+- **Identify popular topics**: Use top searches to understand what content people want to find.
+- **Find content gaps**: Low-confidence searches may indicate missing documentation or topics that need better coverage.
+- **Improve discoverability**: Ensure that pages matching popular search terms are easy to find and well-organized.

From b6ebedf92f30e6cd6840589d933702a467849f9f Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Tue, 16 Sep 2025 11:44:11 -0700
Subject: [PATCH 16/19] update feedback

---
 analytics/feedback.mdx | 55 +++++++++++++++++++++++++++++++++---------
 1 file changed, 44 insertions(+), 11 deletions(-)

diff --git a/analytics/feedback.mdx b/analytics/feedback.mdx
index c46ad18da..96755514f 100644
--- a/analytics/feedback.mdx
+++ b/analytics/feedback.mdx
@@ -1,24 +1,57 @@
 ---
 title: "Feedback"
-description: "TODO: See feedback from your docs"
+description: "Monitor user satisfaction with your documentation"
 ---
 
-### Feedback
-
 <Info>
   To collect and view feedback, you must first enable feedback from the [Add-ons](https://dashboard.mintlify.com/products/addons) page in your dashboard.
 </Info>
 
-The Feedback section displays quantitative thumbs up and thumbs down votes your docs have received and any qualitative feedback that users have provided. You can use this information to discover user needs and make improvements to your docs.
+The feedback tab displays quantitative thumbs up and thumbs down votes your docs have received and any qualitative feedback that users have provided. Use this information to gauge the quality of your docs and make improvements.
+
+Access the feedback tab by navigating to the **Analytics** page in your [dashboard](https://dashboard.mintlify.com/products/analytics).
+
+## Feedback types
+
+The feedback tab displays information according to the feedback add-ons that you enable.
+
+Enable your preferred feedback types:
+
+* **Thumbs rating only**: Simple thumbs up/down voting to gauge overall satisfaction with pages.
+* **Code snippet feedback only**: Feedback specifically on code snippets.
+* **Thumbs rating and contextual feedback**: Page voting plus detailed comments and reasons for ratings.
+* **Thumbs rating and code snippet feedback**: Page voting plus feedback on code examples.
+* **Thumbs rating, contextual, and code snippet feedback**: Complete feedback system with page voting, detailed comments, and code snippet feedback.
+
+## Managing feedback
+
+For contextual and code snippet feedback, you can set the status of a piece of feedback and add internal notes to track your work resolving user feedback.
+
+### Changing feedback status
+
+Select the status beside a piece of feedback to mark it as **Pending**, **In Progress**, **Resolved**, or **Dismissed**.
+
+Best practices for setting feedback statuses:
+
+* **Pending**: Feedback is awaiting review.
+* **In Progress**: Feedback has been validated and is being worked on.
+* **Resolved**: Feedback has been resolved.
+* **Dismissed**: Feedback has been dismissed as not actionable, irrelevant, or inaccurate.
+
+### Filtering by status
+
+Use the status filter to control which feedback is displayed. Uncheck a status to hide all feedback with that status. By default, all feedback is displayed.
+
+### Adding internal notes
 
-If you have enabled **Thumbs rating** feedback, the Feedback section will display:
+Click on a piece of feedback to add an internal note. These notes are only visible to people with access to your dashboard.
 
-- **Liked by viewers**: Pages with the most positive feedback (thumbs up votes).
-- **Needs improvement**: Pages with the most negative feedback (thumbs down votes).
+Use notes to add information for collaboration, link relevant support or engineering tickets, or remember any other useful information.
 
-If you have enabled **Contextual feedback** and **Code snippet** feedback, the Feedback section will display:
+## Using feedback data
 
-- **Context**: Feedback that users have provided for specific pages, including thumps up or down ratings, reasons for the ratings, and any additional comments.
-- **Code**: Feedback that users have provided for specific code snippets.
+Review your feedback data to:
 
-For Context and Code feedback, you can select the status beside a piece of feedback to mark it as Pending, In Progress, Resolved, or Dismissed.
\ No newline at end of file
+* Identify pages with the most positive feedback to see what is working well in your documentation.
+* Identify pages with the most negative feedback to see what needs improvement.
+* Make improvements based on user feedback.

From f532dc39bd8dd6eafc80ffd450411bf1f8e092f7 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Tue, 16 Sep 2025 11:46:51 -0700
Subject: [PATCH 17/19] consistency with other pages

---
 analytics/feedback.mdx | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/analytics/feedback.mdx b/analytics/feedback.mdx
index 96755514f..119cdae63 100644
--- a/analytics/feedback.mdx
+++ b/analytics/feedback.mdx
@@ -52,6 +52,6 @@ Use notes to add information for collaboration, link relevant support or enginee
 
 Review your feedback data to:
 
-* Identify pages with the most positive feedback to see what is working well in your documentation.
-* Identify pages with the most negative feedback to see what needs improvement.
-* Make improvements based on user feedback.
+  * **Identify successful content**: Pages with the most positive feedback show what works well in your documentation.
+  * **Prioritize improvements**: Pages with the most negative feedback indicate what content might need attention.
+  * **Take action**: Make documentation updates based on direct user feedback.

From 73d95100d7be6fce92711e0a97f5cbdee8b52f8c Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Tue, 16 Sep 2025 12:56:25 -0700
Subject: [PATCH 18/19] make improving docs more actionable

---
 analytics/improving-docs.mdx | 42 ++++++++++++++++++++++--------------
 1 file changed, 26 insertions(+), 16 deletions(-)

diff --git a/analytics/improving-docs.mdx b/analytics/improving-docs.mdx
index 10d084369..2e0968b8b 100644
--- a/analytics/improving-docs.mdx
+++ b/analytics/improving-docs.mdx
@@ -3,28 +3,38 @@ title: "Improving your docs"
 description: "Use analytics data to make your documentation better"
 ---
 
-Use your analytics data to enhance the user experience of your docs and identify improvement opportunities.
+Improve your docs based on quantitative and qualitative data from your analytics dashboard.
 
-## Use overview metrics
+## Cross-analytics insights
 
-**Review popular content**: Ensure your most-visited pages contain current, accurate information and consider expanding successful topics.
+Combine information from multiple analytics sources to get a holistic view of your documentation.
 
-**Monitor traffic patterns**: Track changes in visitor counts and page views to understand the impact of updates or new content.
+### Correlate traffic and satisfaction
+- High traffic + low feedback scores = Popular pages with a bad user experience. Prioritize fixing these pages. 
+- Low traffic + high feedback scores = 
+hidden gems worth promoting or expanding
+- High traffic + high feedback scores = your documentation's greatest hits
 
-**Analyze referrer sources**: Understand how users find your docs to optimize external linking and SEO.
+### Match search intent with content performance
+- High search volume + low page views = discoverability problem
+- Popular search terms + low-confidence results = content gap opportunity
+- Top searches + negative feedback on matching pages = content quality issue
 
-## Act on feedback data
+### Identify user journey problems
+- Popular referrer sources + high bounce rates = landing page mismatch
+- Frequent searches + immediate negative feedback = users can't find what they need
+- High code snippet feedback + low page ratings = implementation examples need work
 
-**Address negative feedback**: Investigate pages with poor ratings to identify and resolve user pain points.
+### Find strategic opportunities
+- Rising search trends + no existing popular pages = new content opportunities
+- Declining traffic + stable positive feedback = promotion/SEO needed
+- Consistent negative feedback across referrer sources = fundamental content issues
 
-**Celebrate positive feedback**: Use highly-rated pages as examples of effective documentation patterns.
+## Putting insights into action
 
-**Track feedback trends**: Monitor changes in satisfaction over time, especially after making updates.
+Use these cross-analytics patterns to prioritize your documentation improvements:
 
-## Optimize with search data
-
-**Improve content discoverability**: Review top search queries to ensure relevant pages are easy to find and well-organized.
-
-**Fill content gaps**: Pay attention to low-confidence searches that might indicate missing documentation or topics that need better coverage.
-
-**Update popular content**: Ensure pages that match frequent search terms are current and comprehensive.
+- **Fix high-impact problems first**: Popular pages with poor feedback scores affect the most users
+- **Fill verified content gaps**: Low-confidence searches with high volume indicate clear user needs
+- **Promote hidden successes**: High-rated pages with low traffic deserve better discoverability
+- **Align search and content**: Ensure your most-searched topics have comprehensive, well-organized pages

From 40b2adbbaaa4f72b96daa71af2497f4cad1a879b Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Tue, 16 Sep 2025 13:12:40 -0700
Subject: [PATCH 19/19] polish improving docs

---
 analytics/improving-docs.mdx | 34 ++++++++++++----------------------
 1 file changed, 12 insertions(+), 22 deletions(-)

diff --git a/analytics/improving-docs.mdx b/analytics/improving-docs.mdx
index 2e0968b8b..64426ba7a 100644
--- a/analytics/improving-docs.mdx
+++ b/analytics/improving-docs.mdx
@@ -10,31 +10,21 @@ Improve your docs based on quantitative and qualitative data from your analytics
 Combine information from multiple analytics sources to get a holistic view of your documentation.
 
 ### Correlate traffic and satisfaction
-- High traffic + low feedback scores = Popular pages with a bad user experience. Prioritize fixing these pages. 
-- Low traffic + high feedback scores = 
-hidden gems worth promoting or expanding
-- High traffic + high feedback scores = your documentation's greatest hits
+- **High traffic and low feedback scores**: Popular pages with a poor user experience. Prioritize improving these pages.
+- **Low traffic and high feedback scores**: Documentation that is working well, but might not be discoverable. Consider promoting these pages.
+- **High traffic and high feedback scores**: Your documentation's greatest hits. Review these pages for ideas to improve the rest of your content.
 
 ### Match search intent with content performance
-- High search volume + low page views = discoverability problem
-- Popular search terms + low-confidence results = content gap opportunity
-- Top searches + negative feedback on matching pages = content quality issue
+- **High search volume and low page views**: Discoverability problems. Consider moving these pages or reviewing their frontmatter.
+- **Popular search terms and low-confidence results**: Content gap opportunity. Consider adding more content or new content on these topics.
+- **Top searches and negative feedback on matching pages**: User experience issues. Review the pages to see if they solve the user need that is being searched for.
 
-### Identify user journey problems
-- Popular referrer sources + high bounce rates = landing page mismatch
-- Frequent searches + immediate negative feedback = users can't find what they need
-- High code snippet feedback + low page ratings = implementation examples need work
-
-### Find strategic opportunities
-- Rising search trends + no existing popular pages = new content opportunities
-- Declining traffic + stable positive feedback = promotion/SEO needed
-- Consistent negative feedback across referrer sources = fundamental content issues
-
-## Putting insights into action
+## Put insights into action
 
 Use these cross-analytics patterns to prioritize your documentation improvements:
 
-- **Fix high-impact problems first**: Popular pages with poor feedback scores affect the most users
-- **Fill verified content gaps**: Low-confidence searches with high volume indicate clear user needs
-- **Promote hidden successes**: High-rated pages with low traffic deserve better discoverability
-- **Align search and content**: Ensure your most-searched topics have comprehensive, well-organized pages
+- **Fix high-impact problems first**: Popular pages with poor feedback scores affect the most users.
+- **Fill verified content gaps**: Low-confidence searches with high volume indicate unmet user needs.
+- **Respond to user feedback**: Contextual and code snippet feedback can identify specific areas for improvement.
+- **Align search and content**: Ensure your most-searched topics have comprehensive, well-organized pages.
+- **Monitor rising search trends with no existing popular pages**: New content opportunities.