贡献者路径
这个小节描述了贡献者从起步,到成为帮助塑造 Ansible 未来的领导者历程。咱们可将此作为长期参与的路线图。
迎任何对项目的贡献,哪怕是微不足道的贡献,都是非常欢迎和有价值的。无论是问题反馈、拉取请求、一个论坛话题或文档更改,还是编码贡献,任何贡献都算数。当咱们经常做出贡献时,咱们在相关领域的熟练程度和判断力就会提高,咱们在这个项目中的重要性也会随之增加。
确定咱们感兴趣的领域
首先,要确定出咱们感兴趣的领域。要考虑咱们目前的经验和想获得的东西。例如,如果咱们使用了某个特定的专辑,那就去那里看看。有关如何提供帮助的更多想法,请参阅 "我如何提供帮助?。
找到相应项目
咱们可参与 Ansible 生态中的多个社区项目:
- Ansible Core;
- 专辑;
- AWX;
- Galaxy;
ansible-lint
;- Molecule。
学习
要求的技能取决于咱们感兴趣的领域,及咱们将参与的项目。请记住,最好的学习方法就是边做边学。
代码开发人员所要求的具体知识
代码开发需要最多的技术知识。咱们来梳理一下 Ansible 开发人员应该学习哪些知识。
咱们至少应该了解以下工具的 基础 知识:
咱们可在进行第一批贡献时,更深入地学习这些工具。
每个 Ansible 项目都有自己的贡献者指南。请在准备咱们的首次贡献时,熟悉这些指南。
- Ansible Core 开发;
- Ansible 专辑开发 及专辑代码仓库中的专辑级别贡献者指南。
作出咱们的首次贡献
在 我如何提供帮助? 上,咱们可以找到一些想法。
若咱们有兴趣为专辑做出贡献,请查看专辑的贡献及该专辑代码仓库中的 README
和 CONTRIBUTING
文件。为了让咱们的初次体验尽可能顺利,请仔细阅读代码仓库文档,如有任何问题,请向代码仓库的维护者寻求指导。
请查看那些标有 easyfix
和 good_first_issue
标签的 GitHub issues:
Ansible 专辑 和 其他 Ansible 项目中标有 docs
标签的 Issues,也是很好的开始。
咱们选择了某个要处理的 issue 时,要直接在这个 GitHub issue 上添加评论,说明咱们正在处理该问题,并让其他人知道,以避免工作冲突。如果有需要,咱们还可以在评论中寻求帮助。
继续贡献
我们不期望每个人都无所不知。要从小事做起,从大处着眼。当咱们经常做出贡献时,咱们在相关领域的熟练程度和判断力会迅速提高,同时咱们在项目中的重要性也会随之提高。
请参阅 与 Ansible 社区交流,了解与 Ansible 社区交流和互动的方式,包括工作组会议、访问 Bullhorn 新闻公告和即将举行的贡献者峰会。
教会其他人
通过 改进文档、在 Matrix/Libera.Chat IRC 上回答其他贡献者和用户的问题、就问题和拉取请求提供建议,以及在 论坛 上参与话题讨论等,与其他贡献者分享咱们的经验。
成为某个专辑的维护者
如果咱们是某个专辑的代码贡献者,咱们就可以获得该代码仓库中的扩展权限,而成为一名维护者。专辑维护者是社区信任的贡献者,他们定期为项目做出重要贡献,并显示出自己是相关领域的专家。有关详细信息,请参阅 专辑维护者指南。
对于某些用到 专辑机器人 的专辑,比如 community.general 和 community.network,咱们可以拥有不同级别的访问权限。
- 模组维护者 - 成为专辑维护者之前的阶段。该文件通常是个模组或插件。文件维护者拥有间接提交权;
supershipit
权限 - 与某个文件的维护者类似,但维护者间接提交的范围是整个代码仓库;triage
权限 - 允许贡献者管理 issues 和拉取请求的该代码仓库权限;write
权限 - 又称为例commit
的该代码仓库权限。换句话说,就是成为一名提交者。此访问级别允许贡献者合并拉取请求到development
分支,以及执行 专辑维护者指南 中列出的所有其他活动。
有关权限级别的信息,请参阅 GitHub 官方文档。
成为指导委员会成员
注意:要成为一名指导委员会成员,咱们不必是程序员。
指导委员会 的成员身份,体现了最高级别的信任,允许贡献者通过为 Ansible 项目做出重要决策,领导这个项目。委员会成员是社区的领导者,他们决定着项目的未来和整个 IT 领域自动化的未来。
就像现任委员会成员在获得该地位之前所做的那样,要达到该地位,并完成这个文档中提到的事项,咱们应该:
- 订阅、评论 community topics<creating_community_topic> 和其上投票;
- 提出咱们的主题;
- 若时间允许,要参加 社区的会议。请注意,这 不是 一项要求。
(End)