Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 8 additions & 9 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -166,8 +166,7 @@
"group": "Insights",
"pages": [
"insights/overview",
"insights/feedback",
"insights/search"
"insights/feedback"
]
},
"optimize/seo",
Expand Down Expand Up @@ -243,20 +242,20 @@
"guides/migrating-from-mdx"
]
},
{
"group": "Insights",
"icon": "chart-line",
"pages": [
"guides/improving-docs"
]
},
{
"group": "Git",
"icon": "git-merge",
"pages": [
"guides/git-concepts",
"guides/branches"
]
},
{
"group": "Insights",
"icon": "chart-line",
"pages": [
"guides/improving-docs"
]
}
]
},
Expand Down
14 changes: 1 addition & 13 deletions guides/improving-docs.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,26 +5,14 @@

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.

Check warning on line 10 in guides/improving-docs.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

guides/improving-docs.mdx#L10

Use 'that's' instead of 'that is'.
- **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 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.
24 changes: 0 additions & 24 deletions insights/search.mdx

This file was deleted.