贡献

我们欢迎并非常感谢任何形式的贡献！每一份微小的帮助都至关重要，且我们一定会给予相应的致谢。

联系方式

加入 Ansible 论坛，这是进行问题咨询与求助、开发讨论、活动交流等内容的默认沟通平台。请 注册以加入社区。您可以通过类别和标签搜索感兴趣的话题，或发起一个新话题；请仅订阅您需要的话题！

• 获取帮助：寻求帮助或帮助他人。如果您发起新的讨论，请添加适当的标签，例如 ansible-rulebook。

• 带有 “ansible-rulebook” 标签的帖子：订阅以参与与项目相关的对话。

• Bullhorn 新闻通讯：用于发布版本更新和重要变更通知。

• 社交空间：与志同道合的爱好者聚集和互动。

• 新闻与公告：跟踪包括社交活动在内的全项目公告。

请参阅 浏览 Ansible 论坛 以获取一些关于如何寻找信息的实用建议。

贡献类型

您可以通过多种方式做出贡献

报告 Bug

请在 https://github.com/ansible/ansible-rulebook/issues 报告 Bug。

如果您在报告 Bug，请包含以下内容：

• 您的操作系统名称以及 ansible-rulebook --version 的输出结果

• 任何可能有助于故障排查的本地环境配置详情。

• 重现该 Bug 的详细步骤。

修复 Bug

浏览 GitHub 的 issues 以寻找 Bug。任何标记为 “bug” 和 “help wanted” 的问题都面向所有希望实现修复的人开放。

实现功能

浏览 GitHub 的 issues 以寻找新功能需求。任何标记为 “enhancement” 和 “help wanted” 的问题都面向所有希望实现该功能的人开放。

编写文档

ansible-rulebook 始终需要更多的文档，无论是作为官方 ansible-rulebook 文档的一部分，在代码文档字符串（docstrings）中，甚至是在网络上的博客文章、技术文章等。

Pull Request 指南

在提交 pull request 之前，请检查其是否符合以下指南：

1. Pull request 应包含测试。

2. 如果 pull request 添加了新功能，则应更新文档。请将新功能放入带有文档字符串的函数中，并将该功能添加到 README.rst 的列表中。

3. Pull request 应适用于 Python 3.9

4. 提交信息（Commit messages）必须符合 约定式提交 (conventional commit) 规范

提交反馈

发送反馈的最佳方式是在 https://github.com/ansible/ansible-rulebook/issues 提交一个 issue。

如果您在提议一项新功能：

• 详细解释该功能将如何运作。

• 尽可能缩小功能范围，以便于实现。

• 请记住，这是一个由志愿者驱动的项目，我们非常欢迎您的贡献 :)