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 添加到审核人列表中,以 请求所有者覆盖。请谨慎使用以下流程, 如果评价是由本地业主提供,将会优先显示 给开发者带来的负担过重。