维护者职责
Ansible 集合维护者是社区信任的贡献者,他们对项目做出了重大和定期的贡献,并且已证明自己是相关领域的专家。集合维护者在集合范围内拥有扩展权限。
Ansible 集合维护者会及时对他们维护的集合的 pull 请求或问题提供反馈、回复或操作。他们还可以与 Ansible 社区团队和该集合的其他维护者合作,更新该集合的贡献者指南。
总的来说,集合维护者
根据社区行为准则行事。
订阅他们维护的集合存储库(在 GitHub 中点击Watch > All activity)。
保持 README、开发指南和其他通用集合维护良好的集合文档的相关性。
审查和提交其他贡献者做出的更改。
回退对稳定分支的更改。
解决问题或将问题分配给合适的贡献者。
发布集合.
确保集合符合Ansible 社区打包集合要求。
跟踪“影响集合贡献者和维护者的更改”中宣布的更改,并根据这些更改更新集合。
订阅并向Bullhorn 新闻通讯提交新闻。
构建健康的社区以增加围绕集合的活跃贡献者和维护者的数量。
修改这些指南以改善你和其他人的维护者体验。
多个维护者可以互相分担职责。
如何成为维护者
有兴趣成为维护者并满足要求的人可以自我提名或由其他维护者提名。
要提名候选人,请在相关集合存储库中创建一个 GitHub 问题。如果没有回复,存储库没有得到积极维护,或者当前维护者没有权限添加候选人,请在Ansible 社区论坛中创建一个主题。
作为集合维护者进行沟通
强烈鼓励维护者订阅“影响集合贡献者和维护者的更改”GitHub 存储库和Bullhorn 新闻通讯。如果你需要通过新闻通讯宣布重要事项(例如,最近的发布),请查看 Bullhorn 了解如何操作。
集合贡献者和维护者还可以通过以下方式进行沟通
与他们的集合相关的实时聊天和论坛主题,或者如果没有,则通过一般的社区和开发人员聊天频道。
集合项目看板、问题和 GitHub 讨论,在相应的存储库中。
贡献者峰会和 Ansible 社区日。
Ansiblefest 和当地聚会。
有关这些沟通渠道的更多详细信息,请参阅与 Ansible 社区沟通。
建立工作组沟通
工作组依赖于高效的沟通。项目维护者可以使用以下技术来建立工作组的沟通
请求一个新的工作组来处理你的项目。
在项目的贡献者部分
README.md
中提供工作组详细信息和聊天室链接。鼓励贡献者加入论坛组和聊天室。
有关实时聊天的更多信息,请参阅沟通指南。
社区主题
社区和指导委员会会异步讨论和投票社区主题,这些主题会影响整个项目或其部分,包括集合和打包。
分享你的意见并对主题进行投票,帮助社区做出最佳决策。
贡献者峰会
每季度一次的 Ansible 贡献者峰会是一个全球性活动,为我们的贡献者提供了一个很好的机会,让他们彼此见面、交流、分享想法,并看到 Matrix 或 Libera Chat IRC 或 GitHub 上的消息背后还有真实的人。这会产生社区感。关注Bullhorn 新闻通讯,了解下次贡献者峰会的信息,邀请你认识的贡献者,一起参加活动。
每周社区 Matrix/IRC 会议
社区和指导委员会在#ansible-community
Libera.Chat IRC频道或桥接的#community:ansible.com房间(在Matrix上)每周举行会议,讨论重要的项目问题。加入我们!这是我们的时间表。
扩展集合社区
注意
如果您发现扩展社区或使其更强大的好方法,请编辑此部分并分享您的想法,与其他收藏维护人员分享。
以下是一些扩展您收藏周围社区的方法
给予 新人积极的初次体验。
邀请贡献者加入与您的项目相关的论坛组和 实时聊天。
拥有 良好的文档,其中包含针对新贡献者的指南。
让每个人都感受到个人和集体的欢迎。
使用标签来显示简单的修复,并将非关键的简单修复留给新手,并提供指导。
对问题、PR和其他沟通做出快速响应。
定期举办PR日。
对违反 社区行为准则 的行为采取零容忍政策。
在您的
README
和CONTRIBUTING
文件中加入有关如何举报行为准则违规行为的信息。在您的
README
中加入贡献者可以帮助的快速方法和其他文档。添加并保持更新
CONTRIBUTORS
和MAINTAINERS
文件。创建一个固定问题,宣布该收藏欢迎新的维护人员和贡献者。
在活跃的贡献者中寻找新的维护人员。
宣布您的收藏欢迎新的维护人员。
参加贡献者峰会,并祝贺新的维护人员。
鼓励新贡献者
易修复项目是吸引和指导新贡献者的最佳方式。您应该对传入的问题进行分类,并在适当的情况下使用标签,例如 easyfix
、waiting_on_contributor
和 docs
来标记它们。不要自己修复这些微不足道的非关键错误。相反,指导想要贡献的人。
对于一些简单的修复问题,您可以询问问题报告者是否希望自己修复问题,并提供创建 PR 的快速入门指南链接。
定期举办拉取请求日。您可以计划 PR 日,例如每个月的最后一个星期五,届时您和其他维护人员将审查所有未解决的问题和拉取请求,重点关注旧的请求,询问人们是否需要帮助,等等。如果有一些看起来被放弃的拉取请求(例如,自从上次 PR 日以来,您提供的帮助建议没有得到回复),宣布任何其他感兴趣的人都可以完成该拉取请求。
将满足 要求 的活跃贡献者提升为维护人员。定期审查贡献者的活动。
如果您的收藏找到了新的维护人员,请在 Bullhorn 新闻稿 中宣布这一事实,并在下次贡献者峰会上祝贺并感谢他们所做的工作。您可以提及自上次峰会以来提升的所有人员。请记住提前邀请其他维护人员参加峰会。
鼓励贡献者的其他一些一般性指南
欢迎作者并感谢他们提出的问题或拉取请求。
如果报告了非关键的易修复错误,请礼貌地要求作者自己修复它,并提供 创建第一个收藏拉取请求 的链接。
在提出更改建议时,尽量使用问题,而不是陈述。
在提出强制性更改建议时,请尽可能礼貌,并提供文档引用。
如果您的建议是可选的或个人偏好的问题,请明确说明。
在要求添加测试或进行复杂代码重构时,请说明作者如果需要,可以随时寻求澄清和帮助。
如果有人提出了好主意,请提及它或点赞。
合并后,感谢作者和审阅者的时间和努力。
有关合并 PR 之前需要检查的项目列表,请参阅 收藏 PR 审查清单。
维护良好的收藏文档
维护人员负责照看收藏文档,以确保它符合 Ansible 文档风格指南。这包括定期保持以下文档的准确性和更新
符合 Ansible 文档格式 的收藏模块和插件文档。
遵循 收藏文档格式 的收藏用户指南。
存储库文件,其中至少包含
README
和CONTRIBUTING
文件。
一个好的 README
包含收藏的描述、指向 社区行为准则 的链接,以及有关如何贡献的详细信息或指向 CONTRIBUTING
文件的指针。如果您的收藏是 Ansible 的一部分(与 Ansible 包一起提供),请在收藏的 README
的顶部突出显示这一事实。
该
CONTRIBUTING
文件包含所有详细信息或指向详细信息的链接,说明新贡献者或持续贡献者如何为该收藏做出贡献。该CONTRIBUTING
文件应包含
有关新贡献者指南的信息或链接,例如打开 PR 的快速入门。
有关贡献者要求的信息或链接,例如单元测试和集成测试要求。
您可以选择包含 CONTRIBUTORS
和 MAINTAINERS
文件来列出收藏的贡献者和维护人员。