所有者

Fuchsia 中的每个文件都有一组所有者。这些对象在文件中进行跟踪 名为 OWNERS。以下某个文件位于 代码库中,而且许多目录也有自己的 OWNERS 文件。

目录

每个 OWNERS 文件都会按电子邮件地址列出一些 并且可以对该目录的内容进行代码审核。

职责

Fuchsia 要求进行更改以提交Code-Review +2审核, “所有者”文件所提供的功能。此外,许多 OWNERS 文件 包含允许任何人提供此类 +2*

工具

Gerrit 有一个“建议所有者”功能,其中列出了 在给定更改中修改的文件数。如需了解详情,请访问 Gerrit code-owners 插件页面。

格式

Fuchsia 对 OWNERS 使用 Gerrit 文件语法 文件。

以下是一个示例 OWNERS 文件:

# These users are owners
validuser1@example.com
validuser2@example.com

# Users listed elsewhere are also owners
include /path/to/another/OWNERS

# This user is only an owner of the listed file
per-file main.c = validuser3@example.com

最佳做法

  • OWNERS 文件中至少要有两个人员,这一点非常重要。具有多个区域 而 Fuchsia 的族群只有一位所有者,会导致单点故障。有多个 所有者可确保知识和所有权在 Fuchsia 的各个区域间共享。
  • 在适用情况下,include 所有者来自其他文件,而不是列出个人。 这样创建的“可信来源”更少并使 OWNERS 的维护变得更轻松。

所有者覆盖

在某些情况下,更改的作者可能希望覆盖 OWNERS 审核。这主要适用于更改 大部分都是机械,但涉及大部分代码库, 例如,对常用 API 签名进行细微更改。CL 作者可以将 owner-override@fuchsia.dev 添加到审核人列表中,以 请求所有者覆盖。请谨慎使用以下流程, 如果评价是由本地业主提供,将会优先显示 给开发者带来的负担过重。