Sphinx 專案的組織

本指南說明 Sphinx 專案的組織方式。

核心開發者

Sphinx 的核心開發者擁有主要儲存庫的寫入權限。他們可以提交變更、接受/拒絕 pull request,以及管理 issue tracker 上的項目。

準則

以下是針對核心開發者的一些一般準則

  • 有疑問或大量的變更應該以 pull request 的形式提交,而不是直接提交到主要儲存庫。Pull request 在合併之前應由另一位核心開發者審查。

  • 微小的變更可以直接提交,但請務必保持儲存庫處於良好的工作狀態,並在推送變更之前通過所有測試。

  • 當提交由其他人編寫的程式碼時,請在提交訊息和任何相關的 CHANGES.rst 條目中註明原始作者。

成員

核心成員資格取決於持續積極地為專案做出貢獻。一般而言,潛在的核心成員應展現出

  • 對 Sphinx 的一個或多個組件有良好的理解

  • 有提供有幫助、建設性貢獻的歷史

  • 願意投入時間改進 Sphinx

請參閱貢獻 Sphinx 以獲取更多關於如何開始的資訊。

其他貢獻者

您不需要成為核心開發者或擁有寫入權限即可參與 Sphinx 的開發。您可以從 fork 的儲存庫提交補丁或建立 pull request,並讓核心開發者為您新增變更。

同樣地,貢獻不限於程式碼補丁。我們也歡迎協助分類錯誤、對設計決策提供意見、審查現有的補丁和文件改進。更多資訊可以在 貢獻 Sphinx 中找到。

可以在 Sphinx 作者 中找到為 Sphinx 做出貢獻的人員列表。