RFC-0067:Fuchsia RFC 程序的附加內容

RFC-0067:Fuchsia RFC 程序的新增內容
狀態已接受
區域
  • 管理事宜
說明

推出「最後一次呼叫」步驟;呼叫退出條件;新增修訂 RFC 的程序。

Gerrit 變更
作者
審查人員
提交日期 (年-月-日)2020-12-14
審查日期 (年-月-日)2020-02-17

摘要

本 RFC 針對 RFC-0001 中詳述的 Fuchsia RFC 程序提出一些新增項目。我們已將「最後通話」步驟取代「核准」步驟。並列出流程各個步驟的退出條件。介紹修訂 RFC 的程序。

提振精神

這些變更的動機是為了回應我們收到的程序相關意見,並明確說明相關資訊。

在「最後一次通話」步驟中,RFC 的迭代作業完成後,工程委員會成員必須傳送電子郵件至 eng-council-discuss@fuchsia.dev。這項步驟旨在擴大 RFC 的觸及範圍,方法是傳送推播式通知,在做出最終決定前徵求其他意見回饋。

明確指出流程各個步驟的退出條件,可讓您總結並釐清該步驟的預期結果。

除了上述內容外,在「迭代」步驟結束後,工程委員會必須確認相關利害關係人,並視需要進行任何變更。這項作業旨在確保相關人員名單完整,且在程序進入下一個階段前,已與相關人員進行諮詢。

實作

建議對 RFC 程序的每個步驟進行變更

社交

這裡沒有建議的變更。新增下列退出條件。

退出條件:無特定退出條件。這取決於作者的判斷。這個步驟旨在協助作者明確闡述目標和潛在解決方案。如果他們認為已完成這項工作,就可以繼續進行下一個步驟。

草稿

為這個步驟新增下列退出條件。

結束條件:已建立包含 RFC 的 CL。

疊代

在這個步驟中,我們還新增了作者在過程初期廣泛徵求意見,以及由工程委員會驗證利益相關者最終名單的程序。系統會將下列文字新增至 RFC 程序:

「此外,您可以將 CL 傳送至 eng-council-discuss@fuchsia.dev,以便徵求其他意見回饋。」

「在這個步驟結束時,請將利益相關者和他們的角色清單提供給 eng-council@fuchsia.dev。Eng Council 會確認已識別的利益相關者,並視需要建議任何變更。並與任何新識別的利害關係人進行重複測試。」

除了上述內容外,我們也會新增以下附註,協助審查人員提出意見:

給審查人員的注意事項:RFC 程序旨在鼓勵各種觀點和熱烈討論。在公開論壇中提供負面意見通常不容易。如有需要,審查者可以聯絡主管、同事或工程顧問委員會,請他們協助擬定意見,以便在 CL 中有效提供意見。」

結束條件:所有利益相關者均已確認並獲得工程委員會的核准;收集並納入意見回饋。

上次通話

「Approve」步驟已重新命名為「Last call」。這裡的額外步驟是讓工程委員會成員在做出 RFC 相關決定前,先徵求任何最終意見回饋。系統會將下列文字新增至這個步驟:

「一旦 RFC 的迭代作業完成,作者必須傳送電子郵件至 eng-council@fuchsia.dev,要求將 RFC 的狀態改為最後一次呼叫。工程委員會成員會傳送電子郵件給所有利益相關者和 eng-council-discuss@fuchsia.dev,徵求任何最終意見回饋,然後再進入決策階段。我們會在接下來 7 個曆日內開放 RFC 供您提供意見回饋。」

結束條件:所有利害關係人提供意見回饋,並解決所有意見回饋。

提交

如果已核准的 RFC 中含有異議,則必須將相應的理由和做出的任何取捨納入 RFC。以下文字會新增至此部分:

如果已核准的 RFC 中含有異議,在標記清除後,工程顧問委員會成員會指出是否需要在 RFC 中記錄其他資訊。因此,下列文字會新增至此部分:

「Eng Council 會指出 RFC 中是否需要記錄其他資訊,例如採用不同做法或做出權衡的理由。」

系統會為已拒絕的 RFC 指派下一個可用的 RFC 編號。有效文字會變更為:

「如果專案決定拒絕你的 RFC,工程委員會成員會在 CL 中說明 RFC 遭拒,並提供拒絕原因,並為 RFC 指派編號。」

結束條件:已指派 RFC 編號;納入任何適用的理由、取捨和工程顧問委員會的意見回饋;RFC 已合併。

修訂 RFC 的程序

只要符合下列條件,即可修訂現有的 RFC:

  • 說明已核准的內容。
  • 機械性修訂,例如更新連結、說明文件、用法等
  • 後續發現的任何設計改善或小幅變更,例如在實作期間。

如有設計變更,請記錄原始設計目標為何,以及變更的原因和方式。

如有任何重大設計變更,請提交新的 RFC。

  • 在新 RFC 中,請參考原始 RFC,並在標題中明確指出變更類型,例如附加條款。
  • 如果原始 RFC 中的設計已淘汰,請修改原始 RFC 以呼叫此設計,並參照新的 RFC。
  • 如果有多個 RFC 對相同區域進行變更,請建立新的 RFC 來編譯現有的 RFC。請同時修改現有的 RFC,以便參照新的 RFC。

如果 RFC 程序正在更新,請一併更新RFC 程序頁面

缺點、替代方案和未知事項

缺點:在「最後一次通話」步驟中,雖然我們已向 eng-council-discuss@ 推出推播式通知,但我們可能會在 7 個日曆天內未收到任何意見回饋。這是為了確保 RFC 不會開放太久而做出的權衡。

未知項目:隨著 RFC 程序的使用率提高,程序也會持續演進。

既有技術與參考資料

RFC-0001:RFC 程序

RFC-0006:Zircon 的 RFC 程序補充說明