Electron 的議題
如何貢獻議題
對於任何議題,個人基本上可以透過三種方式貢獻
- 透過開啟議題進行討論:如果您認為您在 Electron 中發現了新的錯誤,您應該透過在
electron/electron
議題追蹤器中建立新議題來回報它。 - 透過協助分類議題:您可以透過提供輔助詳細資訊(可重現的測試案例,以示範錯誤)或提供解決問題的建議來做到這一點。
- 透過協助解決議題:這可以透過證明該議題不是錯誤或已修復來完成;但更常見的是,透過開啟一個 pull request,以具體且可審查的方式更改
electron/electron
中的原始碼。
尋求一般協助
Electron 網站列出了取得程式設計協助、回報安全問題、貢獻等等的資源。請僅將議題追蹤器用於錯誤!
提交錯誤報告
若要提交錯誤報告
當在 electron/electron
議題追蹤器中開啟新議題時,使用者將會看到一個範本,應填寫該範本。
如果您認為您在 Electron 中發現了錯誤,請盡您所能填寫範本。
評估報告所需的兩個最重要的資訊是一份錯誤描述和一個重現錯誤的簡單測試案例。如果錯誤可以重現,則更容易修復錯誤。
請參閱如何建立最小、完整且可驗證的範例。
分類錯誤報告
開放議題通常會涉及討論。一些貢獻者可能有不同的意見,包括該行為是錯誤還是功能。此討論是流程的一部分,應保持重點明確、有幫助且專業。
既未提供額外背景資訊也未提供佐證細節的簡潔回覆,既沒有幫助也不專業。對許多人來說,這種回覆令人惱火且不友善。
鼓勵貢獻者協作解決問題並互相幫助取得進展。如果您遇到您認為無效或包含不正確資訊的議題,請解釋為什麼您有這種感覺,並提供額外的佐證背景資訊,並願意被說服您可能是錯的。透過這樣做,我們通常可以更快地達成正確的結果。
解決錯誤報告
大多數議題都是透過開啟 pull request 來解決的。開啟和審查 pull request 的流程與開啟和分類議題的流程類似,但它帶有必要的審查和批准工作流程,以確保提議的變更符合 Electron 專案的最低品質和功能指南。