编辑 Microsoft Learn 文档的概述

感谢你对在 Microsoft Learn 上编辑文档感兴趣! 你的参与有助于确保我们的文档编写完善、最新且准确。 此页面上的信息有助于确定适合哪种参与方式。

先决条件

开始之前,请确保已登录到 GitHub 帐户。 如果没有 GitHub 帐户,请导航到 https://github.com/join 以便完成一个快速且免费的注册流程。

对文档的小幅更改

小幅更改既快速又简单。 小幅更改的示例包括:

  • 修正错别字
  • 修改单个文章
  • 向文章添加一个部分
  • 更正错误
  • 更新断开的链接

如果要进行小幅更改,只需一个 GitHub 帐户即可!

若要进行小幅更改,请选择文章顶部的编辑此文档铅笔图标。 此操作将转到 GitHub 上的源文件,而你可在其中进行更改。 完成后,系统将提示你创建拉取请求 (PR) 以提出更改。 有关此流程的完整演练,请参阅在浏览器中编辑文档

对文档进行重大更改

重大更改需要花费更多时间和精力。 重大更改的示例包括:

  • 需要几天时间才能完成的复杂更改
  • 对要同时提交的多个文章的修订
  • 创建新文章
  • 频繁参与

若要进行重大更改,则需下载并安装一些工具以简化工作。 请按照以下步骤开始:

  1. 安装 Git 和 Markdown 工具
  2. 设置本地 Git 存储库
  3. 对文档进行更改。
  4. 创建 PR。

过程概述

以下流程显示了开始进行小幅与重大更改时所涉及的高级步骤。 请注意,某些项是一次性步骤,而其他项则每次开始新的参与时都会发生。

显示开始执行参与流程的基本工作流的流程流映射。

这张图片以“这是你第一次参与吗?”为判定点开始。 如果是,下一步是“设置 GitHub 帐户”。 如果不是,下一步是另一个判定点“你的更改是次要的吗”? 如果是,下一步是在浏览器中编辑。 如果不是,后续步骤涉及安装创作工具、创建分支和克隆存储库、进行更改、打开拉取请求以及审阅和注销拉取请求。

对培训模块的更改

参与者无法编辑培训模块或提出更改建议。 目前,只有存储在公共存储库中的 Microsoft Learn 文档可开放用于公共参与。