贡献者路径

本节描述了贡献者从起步到成为帮助塑造 Ansible 未来的领导者的成长历程。您可以将此路径作为长期参与的路线图。

对项目的任何贡献，即使是很小的贡献，都非常受欢迎且具有价值。任何形式的贡献都至关重要，无论是对 Issue 的反馈、提交 Pull Request、对主题或文档的修改，还是代码贡献。当您定期进行贡献时，您在相关领域的熟练程度和判断力将会提高，随之而来的是您在项目中的影响力也将随之增加。

确定您的兴趣领域

首先，确定您感兴趣的领域。考虑您目前的经验以及您希望获得的东西。例如，如果您使用了某个特定的 Collection，可以去那里看看。有关如何提供帮助的更多想法，请参阅 我能提供什么帮助？。

寻找相应的项目

Ansible 生态系统中存在多个您可以参与贡献的社区项目

学习

所需的技能集取决于您的兴趣领域以及您将参与的项目。请记住，最好的学习方式就是实践。

针对代码开发者的特定知识

代码开发需要最高的技术知识。让我们梳理一下 Ansible 开发者应该学习的内容。

您应当至少掌握以下工具的基础知识：

在进行首次贡献的过程中，您可以更深入地学习这些工具。

每个 Ansible 项目都有自己的一套贡献者指南。在准备首次贡献时，请熟悉这些指南。

进行首次贡献

您可以在 我能提供什么帮助？ 中找到一些贡献的想法。

如果您有兴趣为 Collection 做出贡献，请参阅 Collection 贡献 以及 Collection 仓库 的 README 和 CONTRIBUTING 文件。为了让您的首次体验尽可能顺畅，请仔细阅读仓库文档，如有任何疑问，请向仓库维护者寻求指导。

您可以关注 GitHub 中标记有 easyfix 和 good_first_issue 标签的 Issue：

在 Ansible Collections 和 其他 Ansible 项目中标记有 docs 标签的 Issue 也是很好的切入点。

当你选择一个 issue 进行处理时，直接在 GitHub issue 上发表评论，说明你正在处理它，以便让其他人知道，避免重复工作。如果你需要帮助，也可以在评论中寻求帮助。

持续贡献

我们并不期望每个人都精通所有内容。从小处着手，志在远方。当您定期贡献时，您在相关领域的熟练程度和判断力将迅速提高，随之而来的是您在项目中的重要性也将随之增加。

有关与 Ansible 社区沟通和交流的方式（包括工作组会议、查阅 Bullhorn 新闻公告以及即将举行的贡献者峰会），请参阅 与 Ansible 社区沟通。

教导他人

通过 改进文档、在 Matrix/Libera.Chat IRC 上回答其他贡献者和用户的问题、为 Issue 和 Pull Request 提供建议，以及在 论坛 上讨论主题，来与其他贡献者分享您的经验。

成为 collection 维护者

如果您是一个 Collection 的代码贡献者，您可以获得仓库的扩展权限并成为维护者。Collection 维护者是受到社区信任的贡献者，他们为项目做出了重大且定期的贡献，并在相关领域展现出了专家水平。详情请参阅 模块维护者指南。

对于一些使用了 Collection Bot 的 Collection（例如 community.general 和 community.network），您可以拥有不同级别的访问权限和权限：

  • 文件级权限：成为 Collection 维护者之前的阶段。文件通常是一个模块或插件。文件维护者拥有间接提交权。

  • Supershipit 权限：类似于文件维护者，但维护者拥有间接提交权的范围是整个仓库。

  • 仓库的分拣 (Triage) 权限：允许贡献者管理 Issue 和 Pull Request。

  • 仓库的写入权限（也称为 commit）：允许贡献者将 Pull Request 合并到开发分支，并执行 模块维护者指南 中列出的所有其他活动。

有关权限级别的详细信息，请参阅 GitHub 官方文档。

成为指导委员会成员

注意

成为指导委员会成员并不要求您必须是一名程序员。

指导委员会 成员身份代表了最高级别的信任，允许贡献者通过为 Ansible 项目做出重要决策来领导项目。委员会成员是塑造项目未来以及 IT 世界自动化未来的社区领导者。

要达到这一状态，除了本文档中提到的事项外，您应该像当前的委员会成员在获得该身份之前那样做以下事情：

  • 订阅、评论并对 社区主题<creating_community_topic> 进行投票。

  • 提出您自己的主题。

  • 如果时间允许，参加 社区会议。请注意，这 不是 必要条件。