为 Microsoft Learn 内容提供反馈

本文介绍如何使用新的反馈体验来为 Microsoft Learn 内容提供反馈。 此统一反馈体验现已在 Microsoft Learn 上的所有文档或培训内容中成为一项标准体验。 该新系统:

  • 可统一各系统以有效整合反馈,其中包括将客户反馈更好地传送给我们的支持、产品与内容团队。
  • 支持面向非英语学习者的全球辅助功能。
  • 允许匿名反馈以保护学习者隐私。
  • 支持使用 Microsoft Learn 的各类用户,而此类人群并非所有人均会经常使用 GitHub。

Microsoft Learn 上的所有内容均采用新的标准体验。 根据具体存储库,除标准反馈体验之外,还可能会出现开源体验。

虽然仅采用标准体验的存储库已不再支持 GitHub 问题,但如果发现错误或想为已启用此功能的任意存储库添加某些内容,则仍可通过创建拉取请求对 Microsoft Learn 文档做出贡献。 此外,仍可通过选择位于页面顶部的编辑铅笔图标,然后选择历史记录来查看某一文章的更改历史记录和参与者:

Screenshot of the history button in GitHub for the web.

先决条件

采用标准体验

新的标准体验允许使用好评/差评控件来提供反馈。 无需登录或创建帐户即可使用此体验。

若要使用标准体验来提供反馈:

  1. 导航到要为其提供反馈的文章。

  2. 找到反馈链接并选择它。

    1. 在仅启用了标准体验的文档中,此链接位于页面顶部以及页面底部的较大框中。

      Screenshot of the feedback link at the top of a documentation page.

    2. 在训练模块中,该链接位于模块登陆页面的顶部以及模块内每个单元的底部。

      Screenshot of the feedback link at the top of a training module.

  3. 如果发现页面有用,请选择“好评”选项;否则,请选择“差评”选项。

  4. 为反馈选择一个或多个原因。 (可选)我们强烈建议使用注释框(支持最多 999 个字符的文本)来提供有关内容的具体反馈。

    Screenshot of the feedback control.

    本地化内容的读者会看到一个附加选项,它可用于提供有关翻译质量的反馈。

    借助反馈控件,可提供有关 Microsoft Learn 内容的反馈。 你的反馈将由 Microsoft 内容编写者而不是产品团队进行评估。

    某些内容团队还可将以下其他链接配置为显示在反馈控件的底部:

    • 提供产品反馈:此链接允许为产品自身而不是内容提供反馈。 选择此链接可转到一个平台,而你可在其中提供产品反馈,而该反馈将由相应的产品团队进行审查。
    • 获取帮助:根据此链接的配置方式,它会转到产品的社区站点或 Q&A 平台。 如果存在特定问题且需社区协助,则可使用这些平台来获取帮助。
  5. 选择提交

注意

你提供的反馈将采用匿名,且 Microsoft 不会从提交中收集个人数据。 在新体验中,不会公开显示反馈以确保客户隐私。 提交反馈后,你不会收到回复。

使用开源体验

开源反馈体验允许开源社区将 GitHub 问题用于与开源产品相关的文档。 启用后,此混合体验会包括位于页面顶部的标准反馈体验,以及位于页面底部用于提交 GitHub 问题的选项:

Screenshot of the open-source experience at the bottom of a documentation page.

若要提交 GitHub 问题,则须具有 GitHub 帐户。 有关详细信息,请参阅创建 GitHub 问题

目前,已为以下存储库启用开源体验:

  • Azure/azure-docs-sdk-dotnet
  • Azure/azure-docs-sdk-java
  • dotnet/AspNetCore.Docs
  • dotnet/docs
  • dotnet/docs-aspire
  • dotnet/docs-desktop
  • dotnet/docs-maui
  • dotnet/entityframework.apidocs
  • dotnet/entityframework.docs
  • dotnet/maui-api-docs
  • MicrosoftDocs/azure-docs-powershell
  • MicrosoftDocs/azure-docs-sdk-node
  • MicrosoftDocs/azure-docs-sdk-python
  • MicrosoftDocs/community-content
  • MicrosoftDocs/microsoft-365-community
  • MicrosoftDocs/PowerShell-Docs
  • MicrosoftDocs/PowerShell-Docs-DSC
  • MicrosoftDocs/PowerShell-Docs-Modules
  • MicrosoftDocs/PowerShell-Docs-PSGet
  • MicrosoftDocs/terminal
  • MicrosoftDocs/Windows-Dev-Docs
  • MicrosoftDocs/WSL
  • Mono/SkiaSharp-API-docs
  • OfficeDev/office-js-docs-pr
  • OfficeDev/office-js-docs-reference
  • OfficeDev/office-scripts-docs
  • OfficeDev/office-scripts-docs-reference
  • Xamarin/essentials