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

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

推出「最後呼籲」步驟;標示退出條件;新增修訂 RFC 的程序。

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

摘要

這份 RFC 建議在 RFC-0001 中詳述的 Fuchsia RFC 程序中,加入幾項內容。「最後一通電話」步驟取代了「核准」步驟。指出流程中每個步驟的退出條件。 介紹修訂 RFC 的程序。

提振精神

這些變更的目的是為了回應我們收到的程序意見,並明確說明一些事項。

在「Last call」步驟中,當 RFC 的疊代作業趨於收斂時,Eng Council 成員必須傳送電子郵件至 eng-council-discuss@fuchsia.dev。我們希望透過這個步驟,在做出最終決定前,以推播通知的形式徵求其他意見回饋,盡可能擴大 RFC 的觸及範圍。

明確指出流程中每個步驟的結束條件,有助於歸納和釐清該步驟的預期成果。

此外,在「疊代」步驟結束時,工程委員會必須確認利害關係人,並視需要進行任何變更。這是為了確保利害關係人清單完整,並在進入下一個程序階段前諮詢過這些人。

實作

對 RFC 程序各個步驟提出的變更

社交

這裡沒有任何建議變更。新增下列結束條件。

退出條件:無特定條件。這取決於作者的決定。 這個步驟旨在協助作者明確目標和可能的解決方案。 如果他們認為已完成這項任務,即可繼續下一個步驟。

草稿

為這個步驟新增下列結束條件。

退出條件:建立包含 RFC 的 CL。

反覆提問

這個步驟新增的內容包括:請作者在程序初期徵求更廣泛的意見,以及請工程委員會驗證最終利害關係人清單。RFC 程序會加入下列文字:

「此外,您也可以傳送電子郵件至 eng-council-discuss@fuchsia.dev,徵求其他意見回饋。」

「在這個步驟的結尾,請將利害關係人及其角色清單提供給 eng-council@fuchsia.dev。Eng Council 會確認所識別的利害關係人,並視需要提出任何變更建議。與任何新發現的利害關係人進行疊代。

除了上述內容外,系統還會新增以下附註,協助審查人員提供意見回饋:

審查人員注意事項:RFC 程序旨在鼓勵各種觀點和熱烈的討論。在公開論壇中給予負面意見回饋通常很困難。如有需要,審查員可以向主管、同儕或工程委員會尋求協助,以便擬定意見回饋,在 CL 中有效傳達。"

退出條件:所有利害關係人皆已確認並獲得工程委員會核准;已徵求並納入意見回饋。

最後點單

「核准」步驟已重新命名為「最後一通電話」。這裡的額外步驟是請工程委員會成員徵求最終意見,再對 RFC 做出決定。系統會將下列文字新增至這個步驟:

「當 RFC 的疊代作業趨於一致時,作者必須傳送電子郵件至 eng-council@fuchsia.dev,要求將 RFC 的狀態移至最後一通電話。工程委員會成員會向所有利害關係人和 eng-council-discuss@fuchsia.dev 傳送電子郵件,徵求最終意見回饋,然後再進入決策步驟。RFC 將在接下來 7 個日曆天開放提供意見回饋。

結束條件:所有利害關係人提供意見回饋,且所有意見回饋都已處理完畢。

提交

如果已核准的 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 程序增修內容