mintlify__docs/zh/guides/improving-docs.mdx

---
title: "提升你的文档"
description: "使用数据与指标来改进文档。"
keywords: ["metrics", "analytics", "bounce rate", "user satisfaction"]
---

<Tip>
  本页介绍如何通过定量指标、定性反馈，以及与业务目标的对齐来衡量文档的成效。
</Tip>

<div id="quantitative-metrics">
  ## 定量指标
</div>

可以考虑的一些示例：

* **页面浏览量（Page views）**：浏览量可以在一定程度上反映成功，但也可能受到机器人流量或重复访问者的影响。如果错误页面或说明页面的浏览量很高，可能意味着你的产品存在更广泛的问题。
* **页面停留时间（Time on page）**：更长的停留时间可能表示更高的参与度，但也可能意味着用户在寻找所需信息时卡住了。
* **跳出率（Bounce rate）**：较高的跳出率可能表示用户没有找到所需内容，也可能表示他们迅速找到了所需信息并满意离开。

关键在于将这些指标随时间或与基线进行对比，识别趋势，并判断它们是否与用户达成目标相一致。

<div id="correlate-traffic-and-satisfaction">
  ### 关联流量与满意度
</div>

使用 Analytics 来识别模式：

* **高流量且低反馈评分**：页面很受关注，但用户体验较差。应优先优化这些页面。
* **低流量且高反馈评分**：文档表现出色，但可能不易被发现。考虑提升这些页面的曝光度。
* **高流量且高反馈评分**：文档中的“精品”。审查这些页面，从中汲取灵感以改进其余内容。

<div id="qualitative-feedback">
  ## 定性反馈
</div>

用定性信息为你的量化指标补充 context：

* **用户反馈**：使用[反馈](/zh/optimize/feedback)功能，通过评分与开放式评论收集用户情绪，帮助你了解哪些有效、用户在哪些环节遇到困难。
* **利益相关方意见**：从支持、工程、客户成功等团队定期获取反馈，发现用户面临的共性问题与改进空间。
* **用户测试**：开展可用性测试，验证用户是否能找到所需答案，以及你的文档是否符合他们的期望。更多用户研究内容，参见[了解你的受众](/zh/guides/understand-your-audience)。

<div id="business-alignment">
  ## 业务对齐
</div>

将文档与更宏观的业务目标对照评估：

* **支持效率**：跟踪文档是否减少了支持工单量或提升了满意度评分，以判断其是否满足用户需求。
* **上手与采用**：监控文档对新用户快速上手的支持程度，从而加速产品采用。
* **留存**：维护良好、易于理解的文档能带来良好的用户体验，有助于降低流失并提升留存率。

<div id="put-analytics-into-action">
  ## 将 Analytics 付诸行动
</div>

使用以下模式来优先推进文档改进：

* **先修复高影响问题**：受欢迎但反馈评分较低的页面影响的用户最多。
* **及时响应用户反馈**：基于上下文和代码片段的反馈可定位具体改进点。
* **聚焦关键用户旅程**：优先处理与产品最重要任务相关的页面。

<div id="related-pages">
  ## 相关页面
</div>

<CardGroup cols={2}>
  <Card title="Analytics 概览" icon="chart-line" href="/zh/optimize/analytics">
    查看 Analytics 数据并跟踪文档表现。
  </Card>

  <Card title="反馈" icon="message-square" href="/zh/optimize/feedback">
    收集并分析用户对文档的反馈。
  </Card>

  <Card title="了解你的受众" icon="users" href="/zh/guides/understand-your-audience">
    研究并定义你的文档目标受众。
  </Card>

  <Card title="SEO" icon="search" href="/zh/optimize/seo">
    为搜索引擎优化你的文档。
  </Card>
</CardGroup>