mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
fbdd913d8e
* Add translation tracker for stale translations audit Generated-By: mintlify-agent * translations: add missing pages and update content for es, fr, zh Phase 1: Add translations for 4 new API analytics pages (feedback-by-page, searches, views, visitors) in es, fr, and zh. Phase 2: Update 3 pages with content changes: - agent/workflows: add "Disable a workflow" subsection - ai/skillmd: add 24-hour generation note - editor/publish: add AI PR title tip, reformat publishing workflows, promote "Publish your changes" heading from h3 to h2 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * update descriptions * translations * translations * translations * Delete TRANSLATION_TRACKER.md * translations * a * a * translations * translations * translations * translations * translations * translations * translations * translations * Update use-cases.mdx * translations * translations * Update ai-native.mdx * Update accordions.mdx * Update accordions.mdx * Update accordions.mdx * translations * translations * Update fonts.mdx * translations * translations: update SEO descriptions for es, fr, zh (150 pages) Update the description: frontmatter field across 150 pages × 3 languages to match the current English descriptions updated on 2026-03-31. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
118 lines
5.0 KiB
Plaintext
118 lines
5.0 KiB
Plaintext
---
|
|
title: "反馈"
|
|
description: "通过内置反馈组件、页面评分和点赞/踩功能监控用户满意度，识别文档需要改进的区域。"
|
|
keywords: ["user feedback","thumbs rating","contextual feedback","satisfaction"]
|
|
---
|
|
|
|
<Info>
|
|
要收集和查看反馈，你必须先在控制台的 [附加组件](https://dashboard.mintlify.com/products/addons) 页面中启用反馈功能。
|
|
</Info>
|
|
|
|
[反馈](https://dashboard.mintlify.com/products/analytics/v2/feedback) 标签页会显示你的文档收到的点赞和点踩等量化投票，以及用户提供的各类定性反馈。使用这些信息来评估文档质量并进行改进。
|
|
|
|
在控制台的 Analytics 页面中查看反馈。
|
|
|
|
<Frame>
|
|
<img
|
|
className="block dark:hidden"
|
|
src="/images/analytics/feedback-light.png"
|
|
alt="Analytics 页面中的反馈标签页。"
|
|
/>
|
|
|
|
<img
|
|
className="hidden dark:block"
|
|
src="/images/analytics/feedback-dark.png"
|
|
alt="Analytics 页面中的反馈标签页。"
|
|
/>
|
|
</Frame>
|
|
|
|
<div id="feedback-types">
|
|
## 反馈类型
|
|
</div>
|
|
|
|
<Note>
|
|
上下文反馈和代码片段反馈目前处于测试版 (Beta) 阶段。要为你的文档站点启用它们，请[联系销售团队](mailto:hahnbee@mintlify.com)。
|
|
</Note>
|
|
|
|
反馈标签页会根据你启用的[反馈附加组件](https://dashboard.mintlify.com/products/addons)显示相应信息。
|
|
|
|
<Frame>
|
|
<img className="block dark:hidden" src="/images/analytics/feedback-addons-light.png" alt="附加组件页面中的反馈开关。" />
|
|
|
|
<img className="hidden dark:block" src="/images/analytics/feedback-addons-dark.png" alt="附加组件页面中的反馈开关。" />
|
|
</Frame>
|
|
|
|
- **点赞评分**：通过简单的点赞/点踩投票来衡量用户对页面的整体满意度。
|
|
- **编辑建议**：允许用户为你的文档提出编辑建议。仅适用于公开的 GitHub 仓库。
|
|
- **提交 Issue**：允许用户直接从文档中在 GitHub 上创建 Issue。仅适用于公开的 GitHub 仓库。
|
|
- **上下文反馈**：针对页面内容的自由填写反馈。
|
|
- **代码片段反馈**：专门针对代码片段的反馈。
|
|
|
|
<div id="collect-email-addresses">
|
|
## 收集邮箱地址
|
|
</div>
|
|
|
|
启用邮箱收集功能，以便用户在提交反馈时可以选择提供自己的邮箱地址。
|
|
|
|
1. 前往控制台中的 [附加组件](https://dashboard.mintlify.com/products/addons) 页面。
|
|
2. 在反馈设置中启用 **Collect reader emails** 开关。
|
|
3. 可选择添加隐私声明，说明你的团队如何使用收集到的邮箱。
|
|
|
|
在[反馈控制台](https://dashboard.mintlify.com/products/analytics/v2/feedback)中查看随反馈一起提交的邮箱地址以及对应的反馈内容。
|
|
|
|
<Note>
|
|
如果你在 `docs.json` 文件中禁用了 `telemetry`，文档页面上的反馈功能将无法使用。
|
|
</Note>
|
|
|
|
<div id="manage-feedback">
|
|
## 管理反馈
|
|
</div>
|
|
|
|
对于带有上下文和代码片段的反馈，你可以为每条反馈设置处理状态，并添加内部备注，以便跟踪你解决用户反馈的进度。
|
|
|
|
<div id="change-feedback-status">
|
|
### 更改反馈状态
|
|
</div>
|
|
|
|
选择反馈项旁边的状态，将其标记为 **待处理 (Pending)**、**进行中 (In Progress)**、**已解决 (Resolved)** 或 **已忽略 (Dismissed)**。
|
|
|
|
设置反馈状态的最佳实践：
|
|
|
|
- **待处理 (Pending)**：反馈正在等待审核。
|
|
- **进行中 (In Progress)**：正在进行修复工作以解决该反馈。
|
|
- **已解决 (Resolved)**：反馈已被解决。
|
|
- **已忽略 (Dismissed)**：反馈不相关或不准确。
|
|
|
|
<div id="filter-by-status">
|
|
### 按状态筛选
|
|
</div>
|
|
|
|
使用 **Filters** 菜单来控制显示哪些反馈。取消选中某个状态即可隐藏所有具有该状态的反馈。默认情况下，会显示所有类型的反馈。
|
|
|
|
<div id="filter-by-type">
|
|
### 按类型筛选
|
|
</div>
|
|
|
|
根据你想分析的信息，在 **Ratings by page**、**Detailed feedback** 和 **Code snippets** 之间进行选择。
|
|
|
|
- **Ratings by page**：查看哪些页面获得了最多的正面和负面反馈。使用这些量化数据来识别用户认为最有用和最无用的页面。
|
|
- **Detailed feedback**：查看用户在页面上留下的开放式反馈，以便针对特定页面进行有针对性的改进。
|
|
- **Code snippets**：查看用户在代码片段上留下的开放式反馈，以便针对特定代码块进行有针对性的改进。
|
|
|
|
<div id="add-internal-notes">
|
|
### 添加内部备注
|
|
</div>
|
|
|
|
点击一条反馈可添加内部备注。只有有权访问你控制台的人才能看到这些备注。
|
|
|
|
使用备注来补充协作所需的信息、关联相关的支持或工程工单，或记录任何其他有用的信息。
|
|
|
|
<div id="use-feedback-data">
|
|
## 使用反馈数据
|
|
</div>
|
|
|
|
查看你的反馈数据，以便：
|
|
|
|
- **识别表现良好的内容**：正向反馈最多的页面可以帮助你了解文档中哪些部分效果最好。
|
|
- **优先改进**：负面反馈最多的页面表明哪些内容可能需要优先优化。
|
|
- **采取行动**：根据用户的直接反馈对文档进行更新。 |