Hacktoberfest 与 Microsoft Learn

Hacktoberfest 是在 10 月举行的一年一度的全球活动。 该活动鼓励开源开发人员通过拉取请求 (PR) 参与存储库。 GitHub 托管了许多参与 Microsoft Learn 内容的开放源代码存储库。 其中一些存储库会主动参与 Hacktoberfest 活动。 在本文中,你将了解如何发现哪些存储库正在接受 PR,以及你作为参与者可期待什么结果。

查找存储库

要发现某个 Microsoft Learn 存储库是否正在参与 Hacktoberfest,请查看项目上的 hacktoberfest 主题

GitHub .NET docs repository with hacktoberfest topic.

要筛选带有 hacktoberfest 主题的所有 Microsoft Learn 和 .NET 存储库,请参阅“GitHub 主题:Hacktoberfest

或者,存储库可能转而选择使用 Hacktoberfest 标签。 此标签便于筛选问题。 有关详细信息,请参阅 Filtering issues and pull requests by labels(按标签筛选问题和拉取请求)。

提示

如果你是存储库管理员,并且希望允许存储库参与 Hacktoberfest,请将 hacktoberfest 主题添加到存储库。 有关详细信息,请参阅“按主题对存储库进行分类”。

参与

要参与开放源代码存储库,必须先将帐户配置为参与 Microsoft Learn。 如果尚未完成此过程,请先注册 GitHub 帐户。 此外,还必须注册个人资料来跟踪你的工作量。 请参阅“Hacktoberfest”。

帐户配置完成后,请先通读你想要参与的存储库的根目录处的 CONTRIBUTING.md 文件,并按照文件内容操作。 在参与时,这些文件用作指导。 下面是来自部分常见 Microsoft Learn 存储库的一些示例参与者指南:

除了参与 Markdown 文件,如果存储库具有 CODE_OF_CONDUCT.md 文件,则必须遵循社区中的预期行为。 同样,下面是一些常见示例:

有关详细信息,请参阅“Hacktoberfest:参与者”。

选择问题

若要查找要在正在参与的存储库中处理的问题,请筛选问题来查找 up-for-grabshelp-wanted GitHub 标签。 虽然你可解决其他问题,但专注于具有明确定义的范围且独立的问题要容易得多。 除了 Microsoft Lear 存储库,你还可使用以下面向初学者的网站:

有关详细信息,请参阅 Hacktoberfest:初学者

质量预期

为了成功参与开源 Microsoft Lear 存储库,请创建一个有意义且具有影响力的 PR。 来自 Hacktoberfest 官方网站的以下示例被看作是低质量的贡献内容

  • 自动处理的 PR,了解脚本化打开 PR 来删除空格、修复拼写错误或优化图像。
  • 极具破坏性的 PR,例如使用其他人的分支或提交并发出 PR。
  • 被项目维护者视为障碍而不是帮助的 PR。
  • 明确尝试只是将你的 10 月 PR 计数加 1 的提交。

最后,1 个要求修复拼写错误的 PR 是好的请求,而 5 个要求删除孤立空格的 PR 则不是。

有关详细信息,请参阅“Hacktoberfest:值”。

打开 PR

PR 使参与者能够轻松提议一组更改。 打开 PR 时,请在原始注释中指定它打算参与 hacktoberfest。 成功的 PR 具有下列共同特征:

  • PR 增加了价值。
  • 参与者乐于收到反馈。
  • 明确地表述了预期的更改。
  • 这些更改与现有问题有关。

如果你要在没有相应问题的情况下提议 PR,请先创建一个问题。 有关详细信息,请参阅 GitHub:关于拉取请求

另请参阅