You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: guides/improving-docs.mdx
+1-13Lines changed: 1 addition & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,26 +5,14 @@ description: "Use data to make your documentation better"
5
5
6
6
Improve your documentation based on quantitative and qualitative data from your insights page.
7
7
8
-
## Cross-analytics insights
9
-
10
-
Combine information from multiple insights sources to get a holistic view of your documentation.
11
-
12
-
### Correlate traffic and satisfaction
8
+
## Correlate traffic and satisfaction
13
9
-**High traffic and low feedback scores**: Popular pages with a poor user experience. Prioritize improving these pages.
14
10
-**Low traffic and high feedback scores**: Documentation that is working well, but might not be discoverable. Consider promoting these pages.
15
11
-**High traffic and high feedback scores**: Your documentation's greatest hits. Review these pages for ideas to improve the rest of your content.
16
12
17
-
### Match search intent with content performance
18
-
-**High search volume and low page views**: Discoverability problems. Consider moving these pages or reviewing their frontmatter.
19
-
-**Popular search terms and low-confidence results**: Content gap opportunity. Consider adding more content or new content on these topics.
20
-
-**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.
21
-
22
13
## Put insights into action
23
14
24
15
Use these patterns to prioritize your documentation improvements:
25
16
26
17
-**Fix high-impact problems first**: Popular pages with poor feedback scores affect the most users.
27
-
-**Fill verified content gaps**: Low-confidence searches with high volume indicate unmet user needs.
28
18
-**Respond to user feedback**: Contextual and code snippet feedback can identify specific areas for improvement.
29
-
-**Align search and content**: Ensure your most-searched topics have comprehensive, well-organized pages.
30
-
-**Monitor rising search trends with no existing popular pages**: New content opportunities.
0 commit comments