指导委员会的使命和职责

指导委员会的使命是为 Ansible 社区提供连续性、指导和建议,以确保 Ansible 软件包的交付和高质量。此外,该委员会还有助于决定 Ansible 项目的技术方向。它负责批准社区、软件包和社区集合领域的新提案和政策、新的社区集合包含请求,以及其他有关包含和打包的技术方面。委员会应反映 Ansible 社区的范围和广度。

指导委员会的职责

委员会

  • 为社区集合领域设计政策和程序。

  • 投票批准对既定政策和程序的更改。

  • 审查社区集合是否符合政策。

  • 帮助创建和定义我们的可交付成果(例如 ansible 软件包、主要社区集合和文档)的路线图。

  • 审查为包含在 Ansible 软件包中而提交的社区集合,并决定是否包含它们。

  • 审查其他需要委员会关注的重要提案并提供反馈。

现任指导委员会成员

下表列出了现任指导委员会成员。请参阅指导委员会往届成员以获取往届成员列表。

现任指导委员会成员

姓名

GitHub

开始年份

Alexei Znamensky

russoz

2022

Alicia Cozine

acozine

2021

Andrew Klychkov

Andersson007

2021

Brian Scholer

briantist

2022

核心团队代表。

请参阅论坛

2024

Dylan Silva

thaumos

2021

Felix Fontein

felixfontein

2021

James Cassell

jamescassell

2021

John Barker

gundalow

2021

Mario Lenz

mariolenz

2022

Markus Bergholz

markuman

2022

Maxwell G

gotmax23

2022

Sorin Sbarnea

ssbarnea

2021

John Barker ( gundalow ) 已被委员会选为 主席

委员会成员根据他们对 Ansible 项目及其社区的积极贡献来选出。请参阅指导委员会成员资格指南以了解详细信息。

创建新的政策提案和包含请求

委员会使用 Ansible 论坛与社区异步讨论,并在相应的 社区主题中对提案进行投票。

如果要讨论影响以下任何一项的想法,可以创建一个社区主题(请确保使用 项目讨论类别和 community-wg 标签):

  • Ansible 社区

  • 社区集合最佳实践和要求

  • 社区集合包含/排除政策和工作流程

  • 社区治理

  • 其他需要委员会或整个 Ansible 社区关注的重要提案

要请求更改包含策略和Ansible 社区软件包集合要求

  1. 请单击其网页上的 编辑按钮,提交针对该文档的新拉取请求。

  2. 创建一个社区主题,其中包含拟议变更的基本原理。

要提交新的集合以包含在 Ansible 软件包中

  • 请通过 ansible-inclusion 存储库中的新讨论提交新的集合包含请求。

根据您要与社区和委员会讨论的主题,在您准备提案时,请考虑以下方面确立的要求:

社区主题工作流程

委员会使用社区主题工作流程异步讨论并对 社区主题进行投票。

法定人数是指为了正式做出决定而必须对某个主题进行投票的委员会成员的最低人数,它是委员会成员总数的一半。如果法定人数包含小数部分,则向上取整到下一个整数。例如,如果委员会当前有 13 名成员,则法定人数将为 7。

投票必须始终包含“无变更”选项。

如果对某个主题的赞成票和反对票数量相等,则主席的投票将打破平局。例如,如果对某个主题有 6 票赞成和 6 票反对,并且主席的投票属于赞成该主题的 6 票,则最终决定将是肯定的。如果主席尚未投票,则其他成员会要求他们投票。

对于有多个选项的投票,一个选项必须至少获得一半的票数。如果两个选项恰好都获得一半的票数,则主席的投票将打破平局。如果没有一个选项至少获得一半的票数,则必须调整投票选项,以便在新的投票中找到大多数人选择的选项。

社区主题分类

委员会会定期(每三到六个月)对社区主题进行分类。

分类的目标是:

  • 激发人们对被遗忘的主题的兴趣。

  • 识别并关闭不相关的主题,例如,当主题的原因不再存在或主题超出委员会的职责范围时。

  • 识别并关闭社区不感兴趣讨论的主题。作为指标,可以是评论的缺失或评论中没有活动,至少在过去的六个月内。

  • 识别并关闭已解决和实施但未关闭的主题(在这种情况下,可以通过评论说它已实施来立即关闭该主题)。

  • 识别长期处于待定状态的主题,例如,当它等待某人采取行动几个月或当主题已解决但未实施时。

开始分类的人员:

  1. 识别上述主题。

  2. 创建一个特殊的分类主题,其中包含待关闭主题的候选列表。

  3. 考虑到主题的数量、复杂性和评论历史大小,确定一个投票日期,以便为社区提供足够的时间来浏览和讨论它们。

  4. 社区和委员会对分类主题中列出的每个主题候选进行投票,以决定是关闭它还是保持打开状态。

集合包含请求工作流程

在审查社区集合包含请求时,委员会成员会检查集合是否符合Ansible 社区软件包集合要求

注意

即使集合满足要求,如果指导委员会认为该集合的存在将显著降低 Ansible 软件包的用户体验或软件包构建过程,则指导委员会也可以拒绝集合包含请求或将集合从 Ansible 软件包中排除。在拒绝/移除的情况下,集合维护者将收到委员会的全面反馈,解释启动该流程的原因。如果原因是可修复的,则反馈将包含维护者需要更改的信息。

  1. 进行纳入审查的委员会成员将Ansible 社区集合检查清单复制到相应的讨论中。

  2. 在审查过程中,委员会成员会将项目标记为已完成,或者留下评论说明审查员是否期望解决问题,或者是否为可选(例如,在项目下可以写 **必须修复:** <什么> 或 **应该修复:** <什么>)。

  3. 为了将集合包含在 Ansible 社区包中,该集合

  • 必须经过至少两人的审查和批准,其中至少一人是指导委员会成员。

  • 为了让非指导委员会成员的审查被计入纳入,必须由另一位指导委员会成员检查并批准。

  • 审查员不得大量参与集合的开发。他们必须声明任何潜在的利益冲突(例如,是维护者/作者的朋友/亲戚/同事,是集合的用户,或者最近或过去曾为该集合做出贡献)。

  1. 在集合获得两名或更多委员会成员的批准后,委员会成员会创建一个社区主题,并链接到相应的纳入请求。该问题的描述说明该集合已获得两名或更多委员会成员的批准,并设定了一个日期(默认情况下为一周),届时将考虑做出纳入决定。此时间段可用于提出疑虑。

  2. 如果在设定的日期之前没有提出任何异议,则认为纳入请求已成功解决。在这种情况下,委员会成员

  1. 在主题和纳入请求中声明决定。

  2. 将请求移动到 已解决的审查 类别。

  3. ansible-build-data存储库的相应目录中,将集合添加到 ansible.in 文件中。

  4. 通过Bullhorn新闻简报宣布纳入。

  5. 关闭该主题。

集合排除工作流程

委员会使用Ansible 社区包集合移除流程,从 Ansible 包中移除不满足Ansible 社区包集合要求的集合。

社区工作组会议

请参阅社区工作组会议日程安排。会议摘要发布在论坛上。

注意

委员会成员可以自行选择是否参加社区工作组会议。关于社区主题的决定在主题本身中异步进行。