Bazel 特别兴趣组

Bazel 负责托管特别兴趣组 (SIG),以专注于特定领域中的协作,并支持 Bazel 所有者、维护者和贡献者之间的沟通和协调。此政策适用于 bazelbuild

SIG 会公开开展工作。SIG 的理想范围涵盖明确定义的网域,其中大部分成员来自社区。SIG 可以专注于 bazelbuild 中社区维护的代码库(例如语言规则),也可以专注于 Bazel 代码库中的代码区域(例如 Remote Execution)。

尽管并非所有 SIG 都有同等程度的活力、范围、管理模式,但应有足够的证据来证明,如果确立了兴趣组,社区成员会愿意参与并做出贡献中披露政府所要求信息的数量和类型。在加入之前,请先查看该网上论坛的工作,然后与 SIG 负责人联系。成员政策因 SIG 而异。

请参阅 Bazel SIG 的完整列表。

非目标:什么是 SIG

SIG 旨在促进共享工作的协作。因此,SIG 具有以下特点:

  • 不是支持论坛:邮寄名单和 SIG 是不同的概念
  • 不立即要求:在项目生命周期早期,您可能不知道您是否共享了工作或协作者
  • 非劳动:能源是发展和协调工作所需的能源

Bazel 所有者采用保守的 SIG 创建方法 - 由于在 GitHub 上轻松启动项目,因此无需 SIG 即可在许多渠道上进行协作。

SIG 生命周期

本部分介绍了如何创建 SIG。

调研与咨询

若要建议新的 SIG 组,请先收集证据以供审批,如下文所述。您可以考虑下面这些可能的途径:

  • 一组可明确定义的问题或一组问题
  • 与社区成员进行咨询,他们会从中受益,同时评估福利和承诺的意愿
  • 对于现有项目,有贡献者和问题公共关系提供的证据,
  • 此组可达成的目标
  • 运行组的资源要求

即使 SIG 的需求显而易见,研究和咨询对于该团队的成功仍然至关重要。

创建新组

新团体应遵循以下章程。尤其是,它必须展示:

  • Bazel 的明确用途和优势(围绕子项目或应用领域)
  • 两人或更多人愿意担任团体负责人、其他贡献者的存在,以及对相应群体的需求证明
  • 每个群组至少需要使用一个可公开访问的邮寄名单。SIG 可以重复使用其中一个公开列表(如 Bazel-discuss),也可以请求获取 @Bazel.build 的列表,或创建自己的列表
  • SIG 最初所需的资源(通常是邮寄名单和常规视频通话)。
  • SIG 可以通过以下目录从相应目录中提供文档和文件bazelbuild/community或从他们自己的代码库中bazelbuildGitHub 组织。如果 SIG 选择在 bazelbuild GitHub 组织外部对其工作进行整理,则可以关联到外部资源
  • Bazel 所有者批准或拒绝 SIG 应用,并在必要时咨询其他利益相关方

在进入此流程的正式部分之前,您应先咨询 Bazel 产品团队 (product@Bazel.build)。大多数 SIG 需要先经过对话和迭代,然后才能获得批准。

新群组的正式请求是通过以下方式将章程作为 PR 提交给 bazelbuild/community 的,并在采用模板后在 PR 的评论中包含请求 。批准后,将合并组的 PR,并创建所需的资源。

针对新 SIG 的模板请求

如需请求新的 SIG,请使用社区代码库中的模板:SIG-request-template.md

租赁公司

若想建立团队,您需要章程,且必须遵循 Bazel 行为准则。群组的归档将公开显示。成员资格可以不经批准就向所有人开放,也可以请求群组管理员批准。

章程必须提名管理员。除了管理员之外,该群组必须至少包含一人作为主管(可能是同一人),其充当与 Bazel 产品团队协调的联系人。

群组创建者必须将其章程发布到群组邮寄名单中。Bazel GitHub 组织中的社区代码库会将此类文档和政策归档。随着群组的实践和惯例的不断完善,他们应在社区代码库中的相关部分更新其章程。

协作与包容

尽管没有强制性要求,否则群组应选择通过安排的电话会议或聊天渠道进行协作来召开会议。任何此类会议都应在邮寄名单上进行公告,并在之后发布到邮寄名单上的备注。定期会议有助于在 SIG 中推动责任的推进和取得进展。

Bazel 产品团队成员可以主动监控和鼓励群组视情况讨论和采取行动。

启动 SIG

必要活动:

可选活动:

  • 为 Bazel 博客创建博文

SIG 的运行状况及终止

Bazel 所有者会尽最大努力确保 SIG 的运行状况。Bazel 所有者偶尔会请求 SIG 主管报告 SIG 的工作,以将更广泛的活动告知 Bazel 社区。

如果 SIG 不再具有有用的用途或感兴趣的社区,可能会被归档并停止运营。Bazel 产品团队保留归档此类不活跃 SIG 以保持项目整体运行状况的权利,但不太乐于接受这样的结果。如果 SIG 发现其使用期限已过,它还可以选择解散。

注意

此内容已被 Tensorflow 的 SIG 手册采用,并进行了修改。