Ansible 生态系统项目开发资源

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

注意

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

入职工具包

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

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

项目模板

The Ansible project-template 是 Ansible 生态系统项目的 GitHub 仓库模板,其中包含

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

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

请查看从 project-template 构建的docsite,以了解其实际应用。

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

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

社区精选项目列表

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

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