如何贡献代码

RQAlpha 是一个持续更新和维护的项目,它支持 Ricequant 平台的策略回测、实盘交易,因此合并代码是一件非常严谨的事情,这并不意味着我们不希望接受来自开源社区的贡献,反之,我们更愿意拥抱开源,加快产品的迭代、功能的完善、问题的修复。如果您愿意加入进来,共同维护和开发 RQAlpha,请阅读以下文档,希望以下内容可以解答您的疑惑,给您带来帮助。

RQAlpha 所有的开发工作都将会在 RQAlpha Github 上进行,无论是 团队成员还是个人贡献者都需要以同样的方式进行代码提交。

分支管理

master 分支 为最新稳定版本,只有团队成员在发布新版本时才会将充分测试的 develop 分支 合并到 master 分支 中。

develop 分支 为最新开发版本,提交代码需要保证通过所有的测试。

如果是修复bug,需要额外创建 bug/xxx 分支来进行代码提交,测试通过后提交 pull request 并等待 team member 的 merge check.

如果是增加feature, 需要额外创建 feature/xxx 分支来进行代码提交,并完善文档和测试脚本,测试通过后提交 pull request 并等待 team member 的 merge check.

Bugs

如果您在使用的过程中发现了Bug, 请通过 https://github.com/ricequant/rqalpha/issues 来提交并描述相关的问题,您也可以在这里查看其它的issue,通过解决这些issue来贡献代码。

Pull Request

如果您是第一次通过 Pull Request 提交代码, 您可以参考 How to Contribute to an Open Source Project on GitHub 来了解 Contribute Workflow.

我们会认真审核您的 Pull Request, 并给出如下三种回应:

  • Merge Pull Request : 合并您的代码进入 develop 分支
  • Pending : 如果发现有一些地方还需要完善,我们会给出具体的完善建议,并等待您的进一步提交。
  • Won’t Merge : 如果发现您的 Pull Request 不适合合并,我们会给出具体的解释,并关闭相应的issue。

Contribute Workflow

在提交 Pull Request 前,请确保您是按照如下流程进行代码的开发和测试的:

  • Fork RQAlpha Github
  • 基于 develop 分支 创建新的分支,分支命名需要遵循 分支管理 中的命名规则。
  • 如果您修改了代码,请保证通过测试。
  • 如果您修改了API, 请保证文档也同时更新。
  • 如果您增加了新的功能,请保证增加测试代码,

Development Workflow

To Be Continued

Style Guide

PEP8

License

Apache License 2.0