组织Sphinx项目¶
该指南解释了Sphinx项目是如何组织的。
核心开发人员¶
Sphinx的核心开发人员拥有对主库的写访问权限。他们可以在问题跟踪器上提交更改、接受/拒绝Pull请求以及管理项目。
指导方针¶
以下是针对核心开发人员的一些一般指导原则:
有问题的或广泛的更改应该作为拉入请求提交,而不是直接提交到主存储库。在合并之前,拉取请求应该经过另一个核心开发者的审查。
可以直接提交琐碎的更改,但请确保将存储库保持在良好的工作状态,并且在推送更改之前通过所有测试。
当提交其他人编写的代码时,请在提交消息中注明原始作者以及任何相关的
CHANGES.rst
进入。
会籍¶
核心成员资格取决于对该项目的持续积极贡献。一般而言,预期的核心应证明:
对Sphinx的多个组件中的一个有很好的了解
有帮助的、建设性的贡献的历史
愿意投入时间改善Sphinx
参考 对Sphinx的贡献 有关如何入门的详细信息,请参阅。
其他贡献者¶
您不需要是核心开发人员或具有写访问权限就可以参与Sphinx的开发。您可以提交补丁或从分支存储库创建拉取请求,并让核心开发人员为您添加更改。
同样,贡献并不局限于代码补丁。我们还欢迎帮助对错误进行分类、对设计决策的意见、对现有补丁的审查和文档改进。有关更多信息,请参阅 对Sphinx的贡献 。
对Sphinx做出贡献的人的名单可以在 Sphinx作家 。