擁有者

Fuchsia 中的每個檔案都有一組擁有者。透過檔案追蹤 名為 OWNERS。其中一個檔案位於 和許多目錄都有各自的 OWNERS 檔案。

目錄

每個 OWNERS 檔案都會逐一列出個別使用者 (依電子郵件地址) 並可針對該目錄的內容提供程式碼審查。

職責

Fuchsia 需要變更「Code-Review +2」的評論, 「OWNERS」檔案此外,有很多 OWNERS 檔案。 包含 *,允許任何人提供此類 +2

工具

蓋瑞有「建議擁有者」這個按鈕會列出所有 特定變更中修改的檔案詳情請參閱 Gerrit code-owners 外掛程式網頁。

格式

Fuchsia 將 Gerrit 檔案語法用於 OWNERS 檔案。

以下是 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 加入評論者清單 要求擁有者覆寫設定請謹慎運用這項程序 一般而言,我們建議當地擁有者進行審查; 減輕開發人員負擔