建立 RFC

熟悉 RFC (留言要求) 程序及相關標準，您可以 建立提案供 Fuchsia Eng Council 提出審閱。

如要建立 RFC，您必須建立 Gerrit 變更，且必須至少包含 下列三個檔案：

• 建立中繼資料
• 建立 Markdown 檔案
• 建立 _toc.yaml 項目

建立中繼資料

RFC 的中繼資料定義了許多用來填入 RFC 的值 RFC 總覽一文。

如要識別您的 RFC，您需要編輯 docs/contribute/governance/rfcs/_rfcs.yaml，內含您的 RFC 資訊。

您必須根據 RFC 規定提供以下資訊：

- name: 'RFC-NNNN'
  title: 'zx_channel_iovec_t support for zx_channel_write and zx_channel_call'
  short_description: 'This RFC introduces a new mode to zx_channel_write and zx_channel_call that copies input data from multiple memory regions rather than from a single contiguous buffer.'
  authors: ['bprosnitz@google.com']
  file: '0010_channel_iovec.md'
  area: ['Zircon']
  issue: ['60623']
  gerrit_change_id: ['433621']
  status: ''
  reviewers: []
  submitted: '2020-09-25'
  reviewed: ''

建立 RFC 中繼資料後，即可開始撰寫 加入 Markdown 檔案，其中含有 RFC 資訊。

建立 Markdown 檔案

填妥 RFC 中繼資料和 RFC 的 name 後， 為 RFC 建立 Markdown 檔案。

如何建立 Markdown 檔案：

1. 使用 RFC 範本建立新的 Markdown 檔案。這個檔案 必須根據新增至中繼資料檔案的 file 值來命名。

2. 使用文字編輯器編輯檔案時，必須編輯第一行 範本，其中包含 rfcid 變數，其中包含您的 name RFC。舉例來說，如果 name 是 "RFC-NNNN"，則第一行看起來應該像是 包括：

   
   {% set rfcid = "RFC-NNNN" %}
   

3. 請先填寫 RFC 的不同部分 ## 摘要標題。

Markdown 檔案填妥後，即可開始建立 RFC 目錄中的項目

建立 _toc.yaml 項目

為 RFC 建立中繼資料並建立 Markdown 檔案後， 即可開始在 TOC 中列出 RFC (目錄)。

如何新增 TOC 項目：

1. 編輯 //docs/contribute/governance/rfcs/_toc.yaml 檔案。
2. 請在最後一個項目下方新增 RFC 項目，格式如下：

   - title: "name: title"
     path: /docs/contribute/governance/rfcs/file.md

- title: "RFC-0001: RFC Process"
  path: /docs/contribute/governance/rfcs/0001_rfc_process.md

其中 name、title 和 file 是您在 中繼資料檔案

建立 TOC 項目後，現在可以將 RFC 送審。

將變更送審

編輯中繼資料檔案後，請建立 Markdown 檔案並新增 TOC 項目，您現在可以建立變更項目並送交審查了。

變更修訂訊息的第一行必須是 [rfc]，後面接著 RFC 的名稱修訂訊息的內文也可能包含 RFC 的簡短 生成 3D 物件例如：

[rfc] zx_channel_iovec_t support for zx_channel_write and zx_channel_call

This RFC introduces a new mode to zx_channel_write and zx_channel_call that
copies input data from multiple memory regions rather than from a single
contiguous buffer.

將您的變更郵寄給第一組審查員。Fuchsia Eng Council 將 會自動收到 RFC 建立資訊的通知。

如要進一步瞭解如何在 Fuchsia 專案中建立變更，請參閱 做出變更。

變更 RFC 提案狀態

變更完成後，Fuchsia Eng Council (該委員會) 說明提案是否被接受或拒絕。無論 您的提案最終狀態，系統會為您指派 RFC 號碼 無論最終狀態為何，都請務必提交每個提案

獲得工程委員會最終資格後，請採取下列行動：

1. 在 RFC 檔案 (副檔名為 .md) 中編輯指派的 RFC 的 name。舉例來說，如果您獲派 RFC-9999 角色， 第一行應如下所示：

   
   {% set rfcid = "RFC-9999" %}
   

2. 使用指派的 RFC 號碼重新命名 RFC 檔案 (副檔名為 .md)。例如： 如果您獲派「RFC-9999」，請將檔案重新命名為 9999_<filename>.md。

3. 編輯 RFC 中的 TOC 項目 //docs/contribute/governance/rfcs/_toc.yaml 反映 RFC 號碼。 舉例來說，假設您獲派「RFC-9999」，項目看起來可能會像這樣 包括：

   - title: "RFC-9999: My RFC proposal"
     path: /docs/contribute/governance/rfcs/9999_<filename>.md
   

4. 更新 RFC 提案的中繼資料。如果您已正確填寫 您只需要更新 docs/contribute/governance/rfcs/_rfcs.yaml.

   • name：使用指派的 RFC 名稱。例如 "'RFC-9999'。
   • file：使用您在上述步驟中使用的檔案名稱。例如 '9999_<filename>.md'。
   • status：使用指派給您的 RFC 的狀態， 'Accepted' 或 'Rejected'。
   • reviewers：使用變更的審查人員清單。舉例來說 評論者為 abarth@google.com、cpu@google.com 和 vaas@google.com ['abarth@google.com', 'cpu@google.com', 'vaas@google.com']。
   • Reviewed：請使用 RFC 核准日期 (年-月-日) 或遭到拒絕。舉例來說，2020 年 3 月 15 日會是 '2020-03-15'。

   已接受的 RFC 提案中繼資料如下所示：

   - name: 'RFC-0010'
     title: 'zx_channel_iovec_t support for zx_channel_write and zx_channel_call'
     short_description: 'This RFC introduces a new mode to zx_channel_write and zx_channel_call that copies input data from multiple memory regions rather than from a single contiguous buffer.'
     authors: ['bprosnitz@google.com']
     file: '0010_channel_iovec.md'
     area: ['Zircon']
     issue: ['60623']
     gerrit_change_id: ['433621']
     status: 'Accepted'
     reviewers: ['cpu@google.com', 'kulakowski@google.com', 'abarth@google.com', 'pascallouis@google.com']
     submitted: '2020-09-25'
     reviewed: '2020-10-31'
   

5. 將含有變更內容的修補程式上傳到 RFC 檔案。

6. 通過核准後，請與講師合作提交 RFC。具體而言 您的講師必須 +2 CL

您已成功提交 RFC 提案。