Hacktoberfest 是在 10 月举行的一年一度的全球活动。 该活动鼓励开源开发人员通过拉取请求 (PR) 参与存储库。 GitHub 托管了许多参与 Microsoft Learn 内容的开放源代码存储库。 几个存储库积极参与了 Hacktoberfest。
如何参与
在为开放源代码存储库做出贡献之前，你必须首先配置帐户以向 Microsoft Learn 做出贡献。 如果你是这个过程的新手，首先注册一个 GitHub 帐户。 请确保安装 Git 和 Markdown 工具。
若要获得参与的信用，请注册 Hacktoberfest 并阅读他们的参与指南。
查找需要你帮助的存储库
PowerShell-Docs 团队正在支持 Hacktoberfest 对几个 PowerShell 文档库做出贡献。 我们定义了一组清理任务，旨在为首次贡献者提供简单的帮助。 有关完整信息，请参阅 Hacktoberfest 元问题。
要成功完成这些任务，你应该：
- 对 PowerShell 语法有一个大致的了解
- 了解展开
- 能够阅读并遵循 PowerShell-Docs 风格指南和编辑核对清单
- 对 Markdown 有基本的了解
在投稿之前，应该阅读元问题。 准备好开始时，使用以下链接之一打开新的 Hacktoberfest：
- MicrosoftDocs/PowerShell-Docs
- MicrosoftDocs/PowerShell-Docs-DSC
- MicrosoftDocs/PowerShell-Docs-Modules
- MicrosoftDocs/windows-powershell-docs
- MicrosoftDocs/azure-docs-powershell
质量预期
为了成功参与开源 Microsoft Lear 存储库，请创建一个有意义且具有影响力的 PR。 来自 Hacktoberfest 官方网站的以下示例被看作是低质量的贡献内容：
- 包含批量自动更改的 PR
- 示例：脚本化 PR 以删除空白、修复常见拼写或优化图像
- 首先提交一个问题，描述想要进行的自动更改
- 被认为极具破坏性的 PR，例如使用其他人的分支或提交并发出 PR。
- 被视为障碍而非帮助的 PR
- 显然是为了增加 10 月份的 PR 计数的 PR
打开 PR
PR 使参与者能够轻松提议一组更改。 成功的 PR 具有下列共同特征：
- PR 增加了价值。
- 参与者乐于收到反馈。
- 明确地表述了预期的更改。
- 这些更改与现有问题有关。
如果你要在没有相应问题的情况下提议 PR，请先创建一个问题。 有关详细信息，请参阅 GitHub：关于拉取请求。
