贡献指南

本项目旨在为交易社区提供一个强化学习环境。社区中总是有相互竞争的优先级,我们希望确保能够共同实现一个可靠、可持续、可维护的项目。

指导原则

  • 本项目中的代码应该是可靠的
    • 有测试的可靠代码

    • 可工作的可靠代码

    • 不消耗过多资源的可靠代码

  • 我们应该互相帮助,共同实现当前最佳水平(SOTA)

  • 我们应该编写清晰的代码
    • 代码不应冗余

    • 代码应包含内嵌文档(遵循标准 pep 格式)

    • 代码应组织成类和函数

  • 在合理的情况下,我们应利用外部工具

  • 我们共同协作,沟通时应友善、耐心、清晰。不欢迎粗暴无礼的行为。

## 如果你发现了问题,请提出来! * 提交一个 [issue](https://guides.github.com/features/issues/) 是帮助改进项目的好方法

接受 PRs

  • 你发现了一个 bug 并找到了修复方法

  • 你为本项目协调员优先处理的 issue 贡献了解决方案

  • 你新增了功能,并且已经为此功能撰写了 issue、文档和测试

PR 指南

  • 请在每个 PR 中标记 @bruceyang, @spencerromo 或 @xiaoyang。(附注:我们正在寻找更多有软件开发经验的协作者!)

  • 请引用或撰写并引用一个 [issue](https://guides.github.com/features/issues/)

  • 请使用清晰的提交信息

  • 请为新增的每项功能编写详细的文档和测试

  • 请尽量不要破坏现有功能,如果必须破坏,请计划好如何解释其必要性并与协作者协调

  • 请耐心并尊重地对待反馈意见

  • 请使用 pre-commit 钩子

其他

-使用 pre-commit ` pip install pre-commit pre-commit install `

-运行测试 ``` -本地运行 python3 -m unittest discover

-Docker ./docker/bin/build_container.sh ./docker/bin/test.sh ```