反馈

监控用户对你的文档的满意度和反馈。

要收集和查看反馈，你必须先在控制台的 附加组件 页面中启用反馈功能。

反馈标签页会显示你的文档收到的点赞和点踩等量化投票，以及用户提供的各类定性反馈。使用这些信息来评估文档质量并进行改进。

在控制台的 Analytics 页面中查看反馈。

​

反馈类型

上下文反馈和代码片段反馈目前处于测试版（Beta）阶段。要为你的文档站点启用它们，请联系销售团队。

反馈标签页会根据你启用的反馈附加组件显示相应信息。

• 点赞评分：通过简单的点赞/点踩投票来衡量用户对页面的整体满意度。
• 上下文反馈：针对页面内容的自由填写反馈。
• 代码片段反馈：专门针对代码片段的反馈。

如果你在 docs.json 文件中禁用了 telemetry，文档页面上的反馈功能将无法使用。

​

管理反馈

对于带有上下文和代码片段的反馈，你可以为每条反馈设置处理状态，并添加内部备注，以便跟踪你解决用户反馈的进度。

​

更改反馈状态

选择反馈项旁边的状态，将其标记为 待处理 (Pending)、进行中 (In Progress)、已解决 (Resolved) 或 已忽略 (Dismissed)。

设置反馈状态的最佳实践：

• 待处理 (Pending)：反馈正在等待审核。
• 进行中 (In Progress)：反馈已验证且正在处理。
• 已解决 (Resolved)：反馈已被解决。
• 已忽略 (Dismissed)：反馈因无法执行、不相关或不准确而被忽略。

​

按状态筛选

使用状态筛选器来控制显示哪些反馈。取消选中某个状态即可隐藏所有具有该状态的反馈。默认情况下，会显示所有反馈。

​

添加内部备注

点击一条反馈可添加内部备注。只有有权访问你控制台的人才能看到这些备注。

使用备注来补充协作所需的信息、关联相关的支持或工程工单，或记录任何其他有用的信息。

​

使用反馈数据

查看你的反馈数据，以便：

• 识别表现良好的内容：正向反馈最多的页面可以帮助你了解文档中哪些部分效果最好。
  • 优先改进：负面反馈最多的页面表明哪些内容可能需要优先优化。
  • 采取行动：根据用户的直接反馈对文档进行更新。