编辑 Microsoft Learn 文档的概述

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

先决条件

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

对文档的小幅更改

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

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

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

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

对文档进行重大更改

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

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

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

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

过程概述

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

Process flow map showing the basic workflow for getting started with the contribution process.

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

对培训模块的更改

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