跳转到主要内容
要收集和查看反馈,你必须先在控制台的 附加组件 页面中启用反馈功能。
反馈 标签页会显示你的文档收到的点赞和点踩等量化投票,以及用户提供的各类定性反馈。使用这些信息来评估文档质量并进行改进。 在控制台的 Analytics 页面中查看反馈。
Analytics 页面中的反馈标签页。

反馈类型

上下文反馈和代码片段反馈目前处于测试版(Beta)阶段。要为你的文档站点启用它们,请联系销售团队
反馈标签页会根据你启用的反馈附加组件显示相应信息。
附加组件页面中的反馈开关。
  • 点赞评分:通过简单的点赞/点踩投票来衡量用户对页面的整体满意度。
  • 上下文反馈:针对页面内容的自由填写反馈。
  • 代码片段反馈:专门针对代码片段的反馈。
如果你在 docs.json 文件中禁用了 telemetry,文档页面上的反馈功能将无法使用。

管理反馈

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

更改反馈状态

选择反馈项旁边的状态,将其标记为 待处理 (Pending)进行中 (In Progress)已解决 (Resolved)已忽略 (Dismissed) 设置反馈状态的最佳实践:
  • 待处理 (Pending):反馈正在等待审核。
  • 进行中 (In Progress):反馈已验证且正在处理。
  • 已解决 (Resolved):反馈已被解决。
  • 已忽略 (Dismissed):反馈因无法执行、不相关或不准确而被忽略。

按状态筛选

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

添加内部备注

点击一条反馈可添加内部备注。只有有权访问你控制台的人才能看到这些备注。 使用备注来补充协作所需的信息、关联相关的支持或工程工单,或记录任何其他有用的信息。

使用反馈数据

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