Ansible 社区文档

我能提供什么帮助？

感谢您有兴趣帮助 Ansible 项目！

有很多方式可以帮助 Ansible 项目……但首先，请阅读并理解社区行为准则。

成为高级用户 

帮助 Ansible 项目的一个绝佳方式就是成为一名高级用户

在所有可能的地方使用 Ansible
参加教程和课程
阅读官方文档
研读一些关于 Ansible 的优秀书籍
获取认证.

当你成为高级用户后，你以其他方式帮助 Ansible 项目的能力和机会将迅速增加。

在网上提问和回答问题 

有许多 Ansible 用户和贡献者在上面提问和回答问题的在线平台，包括论坛 (Forum)。请与你的 Ansible 同好们联系并交流。

你可以找到官方的 Ansible 沟通渠道。

审查、修复和维护文档 

拼写错误无处不在，即使在 Ansible 文档中也是如此。我们努力保持文档的更新，但你可能也会发现过时的示例。我们提供了便捷的方式来报告和/或修复文档错误。

参加当地的 Meetup 活动 

在世界各地都有 Ansible 的 Meetup 活动。加入你当地的 Meetup，定期参加，提出有意义的问题，并志愿分享你使用 Ansible 的经验。

如果你的附近没有 Meetup，我们很乐意帮助你发起一个。

提交并验证 Issue 

所有软件都有 Bug，Ansible 也不例外。当你发现 Bug 时，通过告知我们，你可以提供巨大的帮助

提交 ansible-core 的 issue。
提交 collections 的 issue。

如果你发现的 Bug 已经有人提交了 issue，你可以通过在该 issue 中评论来验证报告的 Bug 行为，或提供任何补充信息来提供帮助。

审查并提交 Pull Request 

随着你越来越熟悉 Ansible 的工作原理，你可能会能够自行修复 issue 或开发新功能。如果你认为你找到了 Ansible 中某个 Bug 的修复方法，或者你有想与数百万 Ansible 用户分享的新功能，请阅读有关开发流程的全部内容，以了解如何让你的代码被 Ansible 采纳。

你也可以从解决标记为 easyfix 和 good_first_issue 标签的 GitHub issue 开始

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

对于 collections，请参考创建你的第一个 collection pull request 页面，了解如何快速搭建本地环境、测试更改并提交一个可供审查的 pull request。

另一种很好的帮助方式是审查其他 Ansible 用户提交的 pull request。Ansible Core 维护了一份完整的按文件分类的开放 pull request 列表，因此如果你对某个特定的模块或插件感兴趣，你可以轻松跟踪所有相关的新 pull request 并提供测试或反馈。或者，你可以审查你感兴趣的任何 collection 的 pull request。点击 collection 文档页面上的 Issue tracker 即可找到该 collection 的 issues 和 PRs。

成为 collection 维护者 

一旦你了解了开发流程并为 collection 贡献了代码，我们鼓励你成为该 collection 的维护者。在数十个 Ansible collections 中有数百个模块，其中绝大多数完全由 Ansible 社区成员编写和维护。

请参阅 collection 维护者指南以进一步了解成为 Ansible collection 维护者的职责。

加入工作组 

工作组是 Ansible 社区成员围绕特定兴趣话题进行自我组织的一种方式。我们设有涵盖各种主题的工作组。要加入或创建工作组，请阅读 Ansible 工作组。

向他人传授 Ansible 

我们正在开发一个标准化的 Ansible 工作坊，它可以为 Ansible 的使用和概念提供良好的上手介绍。