Skip to content

Commit 40b2adb

Browse files
committed
polish improving docs
1 parent 73d9510 commit 40b2adb

File tree

1 file changed

+12
-22
lines changed

1 file changed

+12
-22
lines changed

analytics/improving-docs.mdx

Lines changed: 12 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -10,31 +10,21 @@ Improve your docs based on quantitative and qualitative data from your analytics
1010
Combine information from multiple analytics sources to get a holistic view of your documentation.
1111

1212
### Correlate traffic and satisfaction
13-
- High traffic + low feedback scores = Popular pages with a bad user experience. Prioritize fixing these pages.
14-
- Low traffic + high feedback scores =
15-
hidden gems worth promoting or expanding
16-
- High traffic + high feedback scores = your documentation's greatest hits
13+
- **High traffic and low feedback scores**: Popular pages with a poor user experience. Prioritize improving these pages.
14+
- **Low traffic and high feedback scores**: Documentation that is working well, but might not be discoverable. Consider promoting these pages.
15+
- **High traffic and high feedback scores**: Your documentation's greatest hits. Review these pages for ideas to improve the rest of your content.
1716

1817
### Match search intent with content performance
19-
- High search volume + low page views = discoverability problem
20-
- Popular search terms + low-confidence results = content gap opportunity
21-
- Top searches + negative feedback on matching pages = content quality issue
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.
2221

23-
### Identify user journey problems
24-
- Popular referrer sources + high bounce rates = landing page mismatch
25-
- Frequent searches + immediate negative feedback = users can't find what they need
26-
- High code snippet feedback + low page ratings = implementation examples need work
27-
28-
### Find strategic opportunities
29-
- Rising search trends + no existing popular pages = new content opportunities
30-
- Declining traffic + stable positive feedback = promotion/SEO needed
31-
- Consistent negative feedback across referrer sources = fundamental content issues
32-
33-
## Putting insights into action
22+
## Put insights into action
3423

3524
Use these cross-analytics patterns to prioritize your documentation improvements:
3625

37-
- **Fix high-impact problems first**: Popular pages with poor feedback scores affect the most users
38-
- **Fill verified content gaps**: Low-confidence searches with high volume indicate clear user needs
39-
- **Promote hidden successes**: High-rated pages with low traffic deserve better discoverability
40-
- **Align search and content**: Ensure your most-searched topics have comprehensive, well-organized pages
26+
- **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+
- **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

Comments
 (0)