From 979256fe6a480daff87aff1f0739ba8915b7b7fd Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Wed, 8 Oct 2025 15:32:32 -0700 Subject: [PATCH 1/3] remove search --- docs.json | 3 +-- insights/search.mdx | 24 ------------------------ 2 files changed, 1 insertion(+), 26 deletions(-) delete mode 100644 insights/search.mdx diff --git a/docs.json b/docs.json index 72aad3b23..bb8a7c4a1 100644 --- a/docs.json +++ b/docs.json @@ -166,8 +166,7 @@ "group": "Insights", "pages": [ "insights/overview", - "insights/feedback", - "insights/search" + "insights/feedback" ] }, "optimize/seo", diff --git a/insights/search.mdx b/insights/search.mdx deleted file mode 100644 index 1b85f402a..000000000 --- a/insights/search.mdx +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: "Search" -description: "Understand how users search within your documentation" ---- - -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 your search metrics by navigating to the **Insights** page in your [dashboard](https://dashboard.mintlify.com/products/insights). - -## 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 returned relevant results - -## Using search data - -Review your search insights to: - -- **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 aca46b59ddf601e8fa4340105db8aa109d11c95c Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Wed, 8 Oct 2025 15:32:46 -0700 Subject: [PATCH 2/3] remove references to search --- guides/improving-docs.mdx | 14 +------------- 1 file changed, 1 insertion(+), 13 deletions(-) diff --git a/guides/improving-docs.mdx b/guides/improving-docs.mdx index 55d73ba70..35a13aff8 100644 --- a/guides/improving-docs.mdx +++ b/guides/improving-docs.mdx @@ -5,26 +5,14 @@ description: "Use data to make your documentation better" Improve your documentation based on quantitative and qualitative data from your insights page. -## Cross-analytics insights - -Combine information from multiple insights sources to get a holistic view of your documentation. - -### Correlate traffic and satisfaction +## Correlate traffic and satisfaction - **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 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. - ## Put insights into action Use these cross-insights 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 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. From 9613f74b7b6a2b615d65e13767f90f933b573fc8 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Wed, 8 Oct 2025 15:37:23 -0700 Subject: [PATCH 3/3] alphabetize guides --- docs.json | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs.json b/docs.json index bb8a7c4a1..3ff9bd13c 100644 --- a/docs.json +++ b/docs.json @@ -242,13 +242,6 @@ "guides/migrating-from-mdx" ] }, - { - "group": "Insights", - "icon": "chart-line", - "pages": [ - "guides/improving-docs" - ] - }, { "group": "Git", "icon": "git-merge", @@ -256,6 +249,13 @@ "guides/git-concepts", "guides/branches" ] + }, + { + "group": "Insights", + "icon": "chart-line", + "pages": [ + "guides/improving-docs" + ] } ] },