练习 - 参与贡献 Microsoft Learn 文档文章

  • 4 分钟

让我们练习参与工作流。 在本练习中，你将对 Microsoft Learn 上的开源文档文章进行细微更改。 然后，通过打开拉取请求来建议所做的更改。

编辑文章

  1. 登录到 GitHub 帐户。

  2. 在浏览器选项卡中，导航到 learn.microsoft.com/contribute/content。

  3. 在文章顶部，选择“编辑”铅笔图标。

    屏幕截图显示“参与”文章已打开，且突出显示了铅笔“编辑”图标。

  4. 选择该铅笔图标以为此存储库创建分支并在分支中编辑或在此项目的分支中编辑此文件。

    屏幕截图显示“参与”文章的源文件已在浏览器中打开，且突出显示了“编辑”图标。

  5. 如果 GitHub 在下一页上提示你创建存储库的分支，请选择“创建存储库的分支”。

  6. “编辑文件”窗格随即打开。 需要向此文章开头添加新句子。 在第二段开头，添加以下句子：“Microsoft Learn 托管 Microsoft 产品和技术的所有文档。”

    屏幕截图显示“参与”文章经过编辑，增加了一个新句子，且突出显示了“提交更改”按钮。

打开 PR

  1. 通过选择“预览”选项卡预览更改。

  2. 完成更改后，查找并选择“提交更改”。

  3. 在“提交消息”字段中，键入“测试参与”。

    屏幕截图显示“提交消息”字段已填写为“TEST 参与”。

  4. 选择“提议更改”。

  5. 在“比较更改”页上，验证“基”是否显示 main。 这意味着更改将拉取到实时存储库的主分支中。

    屏幕截图显示用于验证“基础为主分支”（这意味着更改将会合并到主分支）的页面。

    注意

    如果此页上没有显示 base repository 和 head repository 选项，请选择“跨分支比较”。 这将显示此步骤所需的比较选项。

  6. 选择“创建拉取请求”按钮。

  7. 这会转到“打开拉取请求”页，可在其中预览 PR。

  8. 确认 PR 并选择“创建拉取请求”以打开 PR。

    打开的 PR 的屏幕截图。

注意

由于这是模拟练习，因此你的更改不会合并到实时网站。

恭喜！你已创建 PR！ 它尚未提交，但你已完成参与的第一个主要步骤。 在浏览器中将 PR 选项卡保持为打开状态。 在下一个练习中，你将回到该选项卡。