Docs header transparent bg

錯誤分類

分類是處理使用者開啟的票證的工作。常見的任務包括驗證錯誤、分類票證,以及確保有足夠的資訊供想要嘗試修復錯誤的人員重現錯誤。

我們已建立一個問題範本,引導使用者了解如何報告 Bundler 專案的問題。我們還有一個疑難排解指南來診斷常見問題。

並非每個票證都是 Bundler 程式碼中的錯誤,但開啟的票證通常表示我們可以做些改進來幫助該使用者。有時這表示撰寫額外的文件或讓錯誤訊息更清楚。

分類現有問題

當您查看票證時,以下是主要問題

  • 我是否可以自己重現此錯誤?
  • 重現錯誤的步驟是否清楚記載在票證中?
  • 哪些版本的 Bundler (2.1.x、2.2.x、git 等) 會顯示此錯誤?
  • 哪些作業系統 (macOS、Windows、Ubuntu、CentOS 等) 會顯示此錯誤?
  • 哪些 Ruby (MRI、JRuby、Rubinius 等) 及其版本 (3.0.1、3.1.2 等) 有此錯誤?

分類票證的策略:* 務必要求使用者輸出其 bundle env 的全部內容。有時使用者會忘記在問題中張貼其 bundle env 的所有輸出。* 在看到使用者的 bundle env 輸出後,請嘗試在您的目前環境中複製使用者的問題。每個版本中只會變更部分程式碼庫,因此您的 bundler 版本很可能會有相同的錯誤。* 如果您使用目前的環境遇到複製問題,請慢慢嘗試納入使用者的環境設定。也就是說,這是您開始比對其環境的地方。例如,嘗試逐步切換到使用者的 Ruby、RubyGems、RVM 等版本。* 使用者是否執行最新版本的 bundler?如果不是,請要求他們執行 gem install bundler 來更新。最新版本的 bundler 很可能已經解決了他們的問題。

如果問題仍然需要使用者提供資訊,請套用標籤「需要使用者回饋」。這將有助於在未來找出過期的問題。

如果你無法重現問題,那麼很有可能這個錯誤已經被修正了(歡呼!)。這時可以發文到問題追蹤系統,說明你做了什麼,以及如何解決問題。

如果你可以重現問題,那麼你已經在修復問題的道路上邁進一大步了。 :)

修復你分流的錯誤

歡迎並鼓勵每個人修復任何公開的錯誤、改善錯誤訊息或新增文件。如果你有修復或改善問題追蹤系統的修正,想要貢獻的話,我們有一個小指南可以提供協助

  1. 在現有的問題上討論修復方式。與其他人協調可以避免重複工作,而且如果你需要的話,這是一個獲得建議和點子的好方法。
  2. 檢閱提交請求指南
  3. 將程式碼提交到你的分支中,並至少包含一個測試來涵蓋你的變更。
  4. 從你的錯誤修正分支寄送提交請求給我們。

你不需要在你的提交請求中更新變更日誌。我們的發布腳本會自動從每個提交請求的標題準備變更日誌。

重複!

最後,問題追蹤系統可能是另一個較舊問題追蹤系統的重複。如果你發現問題追蹤系統是重複的,請在問題追蹤系統中留言,註明原始問題追蹤系統的編號。例如,你可以說「這是問題 #42 的重複,可以關閉」。

過期的問題

任何等待更多資訊的問題都可以視為「過期」。處理程序如下

  1. 如果問題一段時間沒有更新(2-4 週),我們通常會留言說「嗨 :wave:,這對你來說仍然是個問題嗎?」。
  2. 如果他們在一兩週內沒有回應,那麼我們就會關閉問題追蹤系統。
  3. 如果他們有回應,而且說這仍然是個問題,那麼我們就會提醒他們我們正在等待更多資訊。
  4. 如果使用者在收到提醒後仍未提供所需資訊,則會關閉此問題單。
如果您發現錯誤或遺漏,請在 GitHub 上編輯此文件