Linus Torvalds 要求核心開發人員編寫更好的Git 合併提交訊息
昨天在宣布Linux 6.12-rc2 核心時,Linus Torvalds 要求核心維護者在提交資訊方面做得更好。 Torvalds 尤其希望核心維護者在描述拉取請求中的變更時,能更好地使用積極、命令式的語氣。
Linux創建者在6.12-rc2 公告中解釋:
總之,說到一個完全不同的話題:我試圖讓我的合併提交資訊具有一定的”凝聚力”,因此我經常編輯拉取請求的語言,使其符合更標準的佈局和語言。 這不是什麼大不了的事,通常只是留白而已,這樣我們就不會有15 種不同的縮排模式和項目符號語法。
但是,如果有些維護者使用被動語態,我會主動重寫解釋(當然,有時我也會覺得自己並不關心如何讓訊息聽起來一致)。
因此,我希望維護者能使用主動語態,最好只是命令式。
換一種說法:
而不是寫成”這修復了…中的NULL 指針解除引用……”,或者特別是如果你只是列出了要點,那麼就把要點寫成”修復……中的NULL 指標解除引用”。
我知道這不是什麼大問題。 但上週我碰巧嘗試重寫了幾個這樣的案例,我覺得簡單明了的語言比較好。
這對合併提交訊息的連貫性會有很大幫助,因為目前合併提交訊息的品質可能會有很大差異,尤其是在Linux 核心合併視窗期間,所有新功能代碼都會出現在拉取請求中,但在周期後期的修復拉取請求中,摘要的品質也會有很大差異。