Sphinx 專案的組織¶
本指南說明 Sphinx 專案的組織方式。
核心開發者¶
Sphinx 的核心開發者擁有主要儲存庫的寫入權限。他們可以提交變更、接受/拒絕 pull request,以及管理 issue tracker 上的項目。
準則¶
以下是針對核心開發者的一些一般準則
有疑問或大量的變更應該以 pull request 的形式提交,而不是直接提交到主要儲存庫。Pull request 在合併之前應由另一位核心開發者審查。
微小的變更可以直接提交,但請務必保持儲存庫處於良好的工作狀態,並在推送變更之前通過所有測試。
當提交由其他人編寫的程式碼時,請在提交訊息和任何相關的
CHANGES.rst
條目中註明原始作者。
成員¶
核心成員資格取決於持續積極地為專案做出貢獻。一般而言,潛在的核心成員應展現出
對 Sphinx 的一個或多個組件有良好的理解
有提供有幫助、建設性貢獻的歷史
願意投入時間改進 Sphinx
請參閱貢獻 Sphinx 以獲取更多關於如何開始的資訊。
其他貢獻者¶
您不需要成為核心開發者或擁有寫入權限即可參與 Sphinx 的開發。您可以從 fork 的儲存庫提交補丁或建立 pull request,並讓核心開發者為您新增變更。
同樣地,貢獻不限於程式碼補丁。我們也歡迎協助分類錯誤、對設計決策提供意見、審查現有的補丁和文件改進。更多資訊可以在 貢獻 Sphinx 中找到。
可以在 Sphinx 作者 中找到為 Sphinx 做出貢獻的人員列表。