Ansible 生态系统项目开发资源

本文档列出了资源,以帮助有兴趣在 Ansible 生态系统 中开发社区项目的贡献者。

注意

欢迎您对本文档中列出的资源或文档本身进行任何改进!请在相应的 GitHub 仓库中提交问题或拉取请求。

入职工具包

Ansible 入职工具包 提供有关为新项目设置 GitHub 仓库以及项目应包含的文档类型的指南。

尽管该工具包最初是为 ansible-community GitHub 组织下的 Ansible 生态系统项目开发的,但欢迎所有人使用它。

项目模板

Ansible project-template 是一个 GitHub 仓库模板,用于 Ansible 生态系统项目,其中包含

  • 每个仓库中通常存在的文件,例如 README、许可证、行为准则等。

  • 一个 docsite 模板,建议您在项目中使用它,以在整个 Ansible 项目生态系统中提供一致的体验。

请查看从 project-template 构建的 docsite,以查看其工作原理。

欢迎您使用该模板,填写项目特定信息,使用 Sphinx 构建它,然后发布它。

即使您的项目不是新的并且已经拥有文档,我们也建议您查看该模板,并检查是否缺少项目用户、贡献者和维护者文档中的任何内容。

社区精选项目列表

无论您的项目仓库是在 ansible-community GitHub 组织下还是在您自己的组织下,都欢迎您将项目包含在 Awesome Ansible 列表 中。

在通过将其添加到列表中让社区了解您的闪亮项目之前,请确保它满足 入职工具包 中解释的标准,以提供最佳的用户和贡献者体验。