mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
Ethan Palm
6cf4585e08
* update analytics intro * update overview intro * update feedback section * update search intro * create Analytics dashboard group * create new analytics pages * update docs.json with new pages * delete guides/analytics * update overview * update search * update improving docs * add link to dashboard * polish overview * fix casing * polish search * update feedback * consistency with other pages * make improving docs more actionable * polish improving docs
31 lines
1.8 KiB
Plaintext
31 lines
1.8 KiB
Plaintext
---
|
|
title: "Improving your docs"
|
|
description: "Use analytics data to make your documentation better"
|
|
---
|
|
|
|
Improve your docs based on quantitative and qualitative data from your analytics dashboard.
|
|
|
|
## Cross-analytics insights
|
|
|
|
Combine information from multiple analytics sources to get a holistic view of your documentation.
|
|
|
|
### 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-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 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.
|