Go Wiki:園藝
什麼是園藝?
「園藝」在開源專案中指的是維護專案健康、成長和美觀的背景維護任務。
此頁面列出常見的 Go 園藝任務。
存取權
如果您已在 Go 社群中定期活躍一段時間,隨時詢問 Gerrit 和/或 GitHub 存取權以修改相關事項。
請參閱 GerritAccess 和 GitHubAccess。
園藝任務
在進行任何園藝工作之前,特別是在問題追蹤器上,請務必熟悉在此描述的問題生命週期:處理問題 - 問題狀態。
修正紅字
查看 https://build.golang.org/ — 有任何紅字嗎?修正、提交錯誤或催促相關人員。無論偶爾或經常,建置面板都不應該顯示紅字。如果樹狀圖顯示紅字,人員無法有效工作,因為 TryBots 和類似工具只會報告失敗情況,遮蔽其他問題。
分類新錯誤
查看未分流的問題。對於 Go,我們會使用特定標籤 (Needs*
或 WaitingForInfo
) 來表示一個問題已被分流。標籤為 Go2
、Proposal
、CherryPickCandidate
、gopls
、pkgsite
的問題有其各自獨立的分流佇列,可以跳過。
在分流錯誤時
- 它是重複的問題嗎?關閉它,並參照重複的問題。
- 它是一個問題,而不是一個錯誤嗎?回應類似「對於 Go 的問題,請參閱 https://go.dev.org.tw/wiki/Questions"。」
- 主旨是正確的格式嗎?它應以套件路徑和冒號開頭:「net/http:修正 foo 作業期間 Server 中的當機問題」。
- 它在子儲存庫中嗎?除非它是會新增到版本中的子儲存庫(例如
http2
),否則將里程碑留為Unreleased
。 - 如果它是一個回歸,且您可以重現,請使用
git bisect
找出有問題的提交(這是選項,但很有幫助)。 - 相關套件是否有一個主要擁有者?在留言中提及他們。如果不是,請新增
help wanted
標籤。 - 如果相關套件沒有擁有者,但看起來本質上很複雜且技術性很深,請新增
ExpertNeeded
標籤。
在問題分流後,新增適當標籤(依照處理問題),以標示問題已分流。
等待資訊
尋找處於等待資訊狀態(https://github.com/golang/go/labels/WaitingForInfo)中的錯誤,並回應它們,在收到回覆後移除標籤,或是在從未收到回覆的情況下關閉錯誤。
「未規劃」錯誤
「未規劃」問題常常會被忽略。查看舊問題,看看是否容易修復(可以移至 Go1.n 或 Go 1.nMaybe 里程碑),或應該關閉。
待處理變更清單
檢閱提交訊息格式,以及已收到的待處理變更清單中測試的存在和程式碼格式,以及錯字/語法。所有這些都可以完成,而無需確認變更本身的正確性。請參閱 https://dev.golang.org/release,取得待處理變更清單的清單。
一旦該區域擁有一個 +1,該區域的所有者就可以給予它一個 +2。
將 +1 視為「已分類」、「或顯然不錯誤」。如果它有測試、格式正確(可能是參考 bug 號碼),並且準備好接受更多檢閱,則給它一個 +1。
待處理的 CL:詢問測試
如果一個新 CL 到來時沒有測試,但可能/應該有測試,請詢問是否能新增測試。或建議如何執行測試。
待處理的 CL:執行 TryBots
如果你有權限(請參閱 GerritAccess)執行 TryBots,並且你看到一個看起來合理(且非惡意的)程式碼的 CL,請啟動 TryBots。(我們從未看過惡意程式碼嘗試從我們的 TryBot 沙盒中逃脫,但這就是為什麼它還不是自動執行的。如果你看到任何情況,請通知我們。)
此內容是 Go Wiki 的一部分。