贡献者路径

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

对项目的任何贡献，即使是微小的贡献，都非常受欢迎且具有价值。无论是对问题的反馈、拉取请求（pull request）、主题或文档的更改，还是代码贡献，任何贡献都至关重要。当您定期贡献时，您在相关领域的熟练程度和判断力会随之提高，同时您在项目中的重要性也会增加。

确定您的兴趣领域

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

寻找相应的项目

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

• Ansible Core

• 集合：

• AWX

• Galaxy

• ansible-lint

• Molecule

学习

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

针对代码开发者的专业知识

代码开发需要最高级别的技术知识。让我们来看看 Ansible 开发者应该学习什么。

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

• Python 编程语言

• Git

• 通过 fork 和 pull request 实现的 GitHub 协作开发模式

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

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

• Ansible Core 开发.

• Ansible collection 开发 以及 collection 仓库中 collection 级别的贡献者指南。

进行首次贡献

您可以在 我能提供什么帮助？ 中找到一些关于如何贡献的建议。

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

查看 GitHub 中带有 easyfix 和 good_first_issue 标签的问题，适用于：

• Ansible collection 仓库

• 适用于所有其他 Ansible 项目

在 Ansible collections 和 其他 Ansible 项目中带有 docs 标签的问题也是很好的切入点。

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

持续贡献

我们不要求每个人都精通所有知识。从小处着手，心怀大志。当您定期贡献时，您在相关领域的熟练程度和判断力将迅速提高，随之而来的是您在项目中的影响力。

请参阅 与 Ansible 社区沟通 了解与 Ansible 社区沟通和互动的方式，包括工作组会议、阅读 Bullhorn 新闻简报以及参加即将举行的贡献者峰会。

教导他人

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

成为 collection 维护者

如果您是某个 collection 的代码贡献者，您可以获得该仓库的扩展权限并成为维护者。Collection 维护者是受到社区信任、对项目有显著且定期贡献并证明自己在相关领域是专家的贡献者。详情请参阅 Collection 维护者指南。

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

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

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

• 仓库分拣权限（Triage access）：允许贡献者管理 issue 和 pull request。

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

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

成为指导委员会成员

注意

成为指导委员会成员**不需要**必须是程序员。

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

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

• 订阅、评论并投票决定 社区主题<creating_community_topic>。

• 提出您自己的主题。

• 如果时间允许，参加 社区会议。请注意，这**不是**一项强制要求。