議題分類與解決

議題分類

所有倉庫通用的議題分類流程。

分類流程

議題應當被盡快打上標簽，顯示議題分類及其他必要信息。在項目管理人進行驗證並納入優先級排期之後，應當把議題加入到對應的項目之中。

議題類別

以下為議題的基本類別。每類議題的解決流程見下一章節。

類別	描述
question	普通問題，回答後或者文檔更新後即可關閉
bug	功能的實現不正確
feature request	新功能請求
enhancement	優化既有功能與當前性能，包括構架調整等
community	對社區規則及協作流程的討論和提案

以下標籤用於對議題提供進一步分類及信息。

Type	Description
needs more info	因缺失信息尚不能對議題進行分類
design	缺少設計，或者對當前設計的討論
under discussion	正在討論該議題的類別
documentation	需要增加或更新文檔
help wanted	值得實現，但是核心團隊囿於精力等限制尚未排期
good first issues	適合新人上手解決的問題

議題解決

所有倉庫通用的解決流程。

解決流程

決定解決的議題應當被加入到對應的項目之中，以便進度跟進。

feature request

新功能提案需要由項目管理人審閱。

• 如果功能已經在設計與開發之中，項目管理人應當提供對應的文檔和資料，並將議題加入到對應的項目之中。
• 如果功能與既有方向和原則相衝突，項目管理人應當提供對應的理由與解釋，必要時加入到文檔之中，並關閉議題。
• 如果功能沒有原則衝突、且尚未進行討論，議題作者應該在 Matters 上發文討論、徵詢社區意見。如果有貢獻者願意提供設計與開發的協助，或者社區有廣泛的支持，項目管理人應當優先排期。需要時可以打上 help wanted 及 design 標籤。

bug

Bug 類需要提供復現方式，否則應當打上 needs more info 標籤。確認 bug 之後：

• 如果嚴重，應當加入到項目中進入排期、分配和跟進。
• 如果不嚴重，同時超過了核心團隊的處理能力，應當打上 help wanted 標籤。
• 如果修復方式簡單直接，應當打上 good first issues 便於初次參與者上手。
• 如果有貢獻者提出 Pull Request，則應當優先審閱與部署。

enhancement

優化類不應有任何功能或者性能上的副作用。

• 如果議題作者或者其他貢獻者提出Pull Request，則應當優先審閱與部署。
• 如果議題作者沒有提出Pull Request，則由開發團隊評估，與其他開發任務統一進行優先級排期。如果優化提案有必要、但超過了核心團隊的處理能力，應當打上 help wanted 標籤。

community

社區規則更新需要由項目管理人最終決定。在達成共識之後，應當打上 documentation 標籤並在補充文檔後關閉。

• 如果不涉及新功能決策，應當由開發團隊與項目管理人審閱，並在GitHub中繼續討論。
• 如果涉及新功能決策，應當由運營團隊與項目管理人審閱，並轉到 Matters 討論。