贡献 Orekit 教程

Orekit 教程是免费软件,这意味着您可以自由使用源代码,无需支付费用,用于您的应用程序,并且您可以改进它并将您的改进包含在下一个主流版本中。

如果您有兴趣参与开发工作,非常感谢!以下是您需要遵循的步骤:

  1. 如果尚未完成,请在 Orekit 教程 forge 上创建一个帐户
  2. 使用 forge 主页上的链接(下图中的红色矩形)分叉 Orekit 教程项目。 fork
  3. 拉取 Orekit 教程的 develop 分支。
  4. 在您的分叉上创建一个新的分支。该分支必须:
    • develop 分支作为源分支。
    • 具有与未来贡献相关的名称。例如,如果您想纠正一个问题,则名称必须为 issue-XXX,其中 XXX 代表问题编号。
  5. 确保激活 checkstyle(使用项目根目录下的 checkstyle.xml 文件)以帮助您遵循 Orekit 的编码规则。
  6. 进行开发和验证。
  7. 更新 src/changes/ 目录中的 changes.xml 文件(参考以前的条目以帮助您)。
  8. 在您的分支上提交您的代码。
  9. 在 forge 上提交合并请求(点击绿色项)。确保将其提交到 develop 分支。默认情况下,GitLab 将建议您将其提交到 master 分支。 merge requests
  10. 等待开发人员之一将您的代码合并到存储库中。

如果您的贡献包括添加或更改大量代码行或类架构,我们建议您在 Orekit 论坛 上讨论贡献。实际上,开发人员可能正在处理您想要修改的代码。此外,论坛是讨论 Orekit 和 Orekit 教程未来添加的好地方。

如果您在贡献过程中有任何问题,您也可以访问论坛并提问。社区越大,Orekit 就会越好。主要规则是,所有打算包含在 Orekit 核心中的内容必须在 Apache 许可证第2.0版下分发。