Bazel 托管了特别兴趣小组 (SIG),将协作重点放在了
并支持 Bazel 所有者、
维护人员和贡献者。本政策
适用于 bazelbuild
。
SIG 都是公开工作的。SIG 的理想范围应涵盖明确定义的
,其中大多数参与者都来自社区。SIG 可以
专注于 bazelbuild
中由社区维护的代码库(例如
或重点关注 Bazel 代码库中的代码区域(如远程
执行)。
尽管并非所有 SIG 都具有相同的能量、范围或 治理模型,应该有足够的证据表明 如果兴趣群体愿意参与进来并做出贡献, 。加入前,请先查看小组的作业,然后与我们联系 交流互动。会员政策因 SIG 而异。
请查看 Bazel SIG。
非目标:SIG 不具有的目标
SIG 旨在促进共同工作的协作。SIG 是指 因此:
- 不是支持论坛:邮寄名单和 SIG 是两码事
- 非立即要求:在项目生命周期的早期阶段,您可能不知道 如果有共享工作成果或协作者
- 非自由劳动:需要能源来发展和协调工作 协作
Bazel Owner 采用保守的方法创建 SIG,这得益于 在 GitHub 上启动项目,有许多途径可以让员工 无需 SIG 即可发布。
SIG 生命周期
本部分介绍了如何创建 SIG。
调研与咨询
要提议新的 SIG 小组,请先按照说明收集证据以供审批 。可以考虑通过以下途径参考:
- 明确定义的问题或小组将解决的一组问题
- 咨询受益的社区成员,评估 以及他们的承诺
- 对于现有项目,提供有贡献者关注的问题的证据和公关信息 关于该主题
- 小组要实现的潜在目标
- 运行群组的资源要求
即使需要 SIG 似乎不言自明,但研究和咨询 仍然对团体的成功至关重要。
创建新群组
新小组应遵循以下签署流程。具体而言, 必须证明:
- 对 Bazel 的明确目的和好处(围绕子项目或 应用领域)
- 两个或更多贡献者愿意以群组负责人的身份执行操作;存在其他 原因,以及对该群组的需求证据
- 每个群组至少需要使用一个可公开访问的邮寄名单。SIG 可以重复使用某个公开列表,例如 bazel-COMMENT,索要清单 @bazel.build ,或创建自己的列表
- SIG 最初所需的资源(通常为邮寄名单和常规资源) 视频通话。)
- SIG 可以在 Google Cloud 控制台中传送其目录中的文档和文件,
bazelbuild/community
也可以从自己的代码库bazelbuild
GitHub 组织。SIG 可以链接到外部资源(如果他们选择组织) 他们在bazelbuild
GitHub 组织之外的工作 - Bazel 负责人会批准或拒绝 SIG 应用,并咨询 利益相关者
在开始正式的流程之前,您应该先咨询 我是 Bazel 产品团队,product@bazel.build。大多数 SIG 都需要对话 在审批前需要反复测试
向新群组提交章程作为公关,从而完成正式申请
bazelbuild/community
,
按照模板将要求添加到 PR 注释中
。审批时,群组的 PR 会合并,所需的资源也会被合并
创建。
新建 SIG 的模板请求
如需申请新的 SIG,请使用社区代码库中的模板: SIG-request-template.md.
租船
要建立群组,您需要章程,并遵循 Bazel 行为准则。 该群组的归档将是公开的。成员资格可向所有人开放 未经批准,或根据请求提供,等待组批准 管理员。
章程必须提名一位管理员。作为管理员, 组必须至少包含一位用户(可能是同一位用户), 根据 Bazel 要求,担任协调联系人 产品团队。
群组创建者必须将章程发布到群组邮寄名单中。社区 GitHub 组织中的代码库,用来归档此类文档和 政策。随着组织的做法和惯例不断完善,他们也应更新 在社区存储库的相关部分查看他们的章程。
协作和包容
尽管非强制性要求,但团体应选择利用协作功能 通过预定的电话会议或聊天渠道进行会议。任何此类 应在邮寄名单上宣传会议, 邮寄名单。定期召开会议有助于提升责任感并取得进步 发布。
Bazel 产品团队成员可以主动监控和鼓励小组 讨论并采取适当行动。
发布 SIG
必做活动:
- 通知 Bazel 常规论坛 (bazel-COMMENT、 bazel-dev).
可选活动:
- 为 Bazel 博客撰写博文
SIG 的健康与终止
Bazel 负责人会尽最大努力确保 SIG 的健康。Bazel 所有者 偶尔请求 SIG 负责人就 SIG 的工作情况进行报告, 更广的 Bazel 社区。
如果 SIG 已经不再有有用的用途或不再感兴趣的社区, 并停止操作。Bazel 产品团队保留 归档此类非活跃 SIG 以保持项目的整体运行状况; 但这个结果不太可取如果存在以下情况,SIG 也可能会选择解散: 它就会识别出自身已达到其使用寿命。
备注
本文内容取自 Tensorflow 的 SIG 策略指南 并进行修改。