Skip to content

Commit e75ed8b

Browse files
committed
update improving docs
1 parent 1248cb7 commit e75ed8b

File tree

1 file changed

+22
-7
lines changed

1 file changed

+22
-7
lines changed

analytics/improving-docs.mdx

Lines changed: 22 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,30 @@
11
---
2-
title: "Improving docs"
3-
description: "TODO: See how to improve your docs with analytics"
2+
title: "Improving your docs"
3+
description: "Use analytics data to make your documentation better"
44
---
55

6+
Use your analytics data to enhance the user experience of your docs and identify improvement opportunities.
67

7-
## Improving your docs with analytics
8-
9-
Use your analytics to enhance the user experience of your docs:
8+
## Use overview metrics
109

1110
**Review popular content**: Ensure your most-visited pages contain current, accurate information and consider expanding successful topics.
1211

13-
**Address feedback concerns**: Investigate pages with negative feedback to identify and resolve user pain points.
12+
**Monitor traffic patterns**: Track changes in visitor counts and page views to understand the impact of updates or new content.
13+
14+
**Analyze referrer sources**: Understand how users find your docs to optimize external linking and SEO.
15+
16+
## Act on feedback data
17+
18+
**Address negative feedback**: Investigate pages with poor ratings to identify and resolve user pain points.
19+
20+
**Celebrate positive feedback**: Use highly-rated pages as examples of effective documentation patterns.
21+
22+
**Track feedback trends**: Monitor changes in satisfaction over time, especially after making updates.
23+
24+
## Optimize with search data
25+
26+
**Improve content discoverability**: Review top search queries to ensure relevant pages are easy to find and well-organized.
27+
28+
**Fill content gaps**: Pay attention to low-confidence searches that might indicate missing documentation or topics that need better coverage.
1429

15-
**Optimize for search**: Review top search queries so that relevant pages are discoverable and up-to-date. Pay attention to low-confidence searches that might indicate content gaps.
30+
**Update popular content**: Ensure pages that match frequent search terms are current and comprehensive.

0 commit comments

Comments
 (0)