Go Wiki: 園藝

什麼是園藝？

在開源專案中，“園藝”指的是為了保持專案健康、持續發展和美觀而進行的後臺維護工作。

本頁列出了常見的 Go 園藝任務。

訪問許可權

如果您在 Go 社群中活躍了一段時間，請隨時申請 Gerrit 和/或 GitHub 訪問許可權以修改內容。

參見 GerritAccess 和 GitHubAccess。

園藝任務

在進行任何園藝工作之前，尤其是在問題跟蹤器上，請記住熟悉問題生命週期，此處有詳細描述：處理問題 - 問題狀態。

修復紅色（構建失敗）

檢視 https://build.golang.org/ — 有什麼顯示為紅色嗎？修復或提交 bug，或催促相關人員。構建儀表板永遠不應該顯示為紅色，即使是偶爾。如果構建樹是紅色的，人們將無法有效工作，因為 TryBots 等工具只會報告失敗，從而掩蓋其他問題。

分類新 bug

檢視 未分類問題。對於 Go，我們使用特定標籤（Needs* 或 WaitingForInfo）來表示一個問題已被分類。已標記 Go2、Proposal、Telemetry-Proposal、CherryPickCandidate、gopls、pkgsite 的問題有各自獨立的分類佇列，可以跳過。

在分類 bug 時

• 是否重複？關閉它，並引用重複項。
• 這是一個問題而不是 bug？回覆類似“關於 Go 的問題，請參見 https://golang.org.tw/wiki/Questions"。”
• 主題格式是否正確？應以包路徑開頭，後跟冒號：“net/http: 修復 Server 在 foo 操作期間崩潰”。
• 是否在子倉庫中？將里程碑保留為 Unreleased，除非它是一個會進入釋出版的子倉庫，例如 http2。
• 如果這是一個迴歸，並且您能夠重現它，請使用 git bisect 查詢導致問題的提交（可選但非常有幫助）。
• 相關包 是否有主要負責人？在評論中提及他們。如果沒有，則新增 help wanted 標籤。
• 如果相關包沒有負責人，但看起來複雜且技術性很強，請新增 ExpertNeeded 標籤。

問題分類後，新增適當的標籤（根據 HandlingIssues）以進行標記。

等待資訊 (WaitingForInfo)

查詢狀態為 WaitingForInfo 的 bug（https://github.com/golang/go/labels/WaitingForInfo）併發送 ping，在收到回覆時移除標籤，或者在從未收到回覆時關閉 bug。

“未計劃”的 bug

“未計劃”的問題往往會被忽視。檢視舊問題，看看它們是否容易修復（並可以移至 Go1.n 或 Go 1.nMaybe 里程碑），或者是否應該關閉。

待處理的 CL (Pending CLs)

檢查提交訊息的格式、測試的存在、程式碼的格式以及待處理的 CL 中的拼寫/語法錯誤。所有這些都可以在不確定更改本身正確性的情況下完成。請參閱 https://dev.golang.org/release 檢視待處理 CL 的列表。

一旦獲得 +1，該區域的負責人就可以給出 +2。

將 +1 理解為“已分類”或“明顯沒有問題”。如果它有測試、格式正確（可能引用了 bug 編號），並且已準備好進行進一步評審，請給出 +1。

待處理的 CL：詢問測試

如果新的 CL 沒有測試，但應該有測試，請詢問是否可以新增測試。或者提出建議。

待處理的 CL：執行 TryBots

如果您有許可權（參見 GerritAccess）執行 TryBots，並且看到一個包含合理（且非惡意）程式碼的 CL，請啟動 TryBots。（我們從未見過試圖逃脫 TryBot 沙盒的惡意程式碼，但這正是它尚未自動化的原因。如果您看到任何內容，請通知我們。）