指导委员会的使命和职责

指导委员会的使命是为 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 软件包中

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

社区主题工作流程

委员会使用 社区主题工作流程 以异步方式讨论和投票 社区主题

法定人数是指必须对主题进行投票才能正式做出决定的最少委员会成员人数,是委员会成员总数的一半。如果法定人数包含小数部分,则向上舍入到下一个整数。例如,如果委员会当前有十三名成员,则法定人数为七。

投票必须始终将“不更改”作为选项。

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

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

社区主题分类

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

分类目标是

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

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

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

  • 识别并关闭已解决和实施但未关闭的主题(在这种情况下,此类主题可以立即关闭,并带有已实施的评论)。

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

开始分类的人

  1. 识别上述主题。

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

  3. 考虑到主题数量、它们的复杂性和评论历史大小,建立投票日期,以便社区有足够的时间浏览和讨论它们。

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

集合包含请求工作流程

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

注意

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

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

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

  3. 要将合集包含在 Ansible 社区软件包中,该合集

  • 必须经过至少两名指导委员会成员的审查并批准符合要求。

    • 至少有一个审查会检查是否符合整个清单。

    • 所有后续审查都可以只关注是否符合文档和开发约定。

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

  1. 在合集获得两名委员会成员批准后,一名委员会成员会创建一个链接到相应包含请求的 社区主题。该问题的描述说明该合集已获得委员会批准,并确定一个日期(默认情况下为一周),届时将考虑做出包含决定。

  • 如果在此时段内委员会成员提出担忧或开始另一项包含审查,则包含会自动暂停。

  • 当没有更多反对意见或正在进行的包含审查时,包含日期将再延长一周。

  1. 如果包含未在既定日期之前被暂停,则认为包含请求已成功解决。在这种情况下,一名委员会成员

  1. 在主题和包含请求中声明该决定。

  2. 将请求移至 已解决 审查 类别。

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

  4. 通过 Bullhorn 新闻稿宣布包含。

  5. 关闭该主题。

合集排除工作流程

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

社区工作组会议

请参阅社区工作组会议 时间表。会议摘要发布在 论坛上。

注意

社区工作组会议的参与对于委员会成员是可选的。关于 社区主题 的决定是在主题本身中异步做出的。