捐款

在开始为 ROS 2 项目做贡献之前,有几件事需要记住。

宗旨

  • 尊重前人

    ROS 已有十多年的历史,世界各地的开发人员都在使用它。在做出贡献时,请保持谦逊的态度和开放的心态。

  • 尽早让开放式机器人参与进来

    • Open Robotics 是 ROS 社区的守门人和倡导者。从设计阶段开始,就依靠他们的专业知识和技术判断。

    • 尽早与开放机器人技术公司和社区展开讨论。ROS 的长期贡献者可能对大局有更清晰的认识。如果不先与社区讨论就实施功能并发送拉取请求,就有可能被拒绝,或者被要求重新考虑设计。

    • 一般来说,在开始实施之前,最好先提出问题或使用 Discourse 将想法社会化。

  • 尽可能采用社区最佳做法,而不是临时流程

    在开发和贡献时,考虑最终用户的体验。避免使用非标准工具或库,因为这些工具或库并非人人都能使用。

  • 考虑整个社区

    从大处着眼。不同的开发者在制造不同的机器人时会遇到不同的限制。ROS 需要满足整个社区的需求。

您可以通过多种方式为 ROS 2 项目做出贡献。

讨论和支持

参与社区讨论和支持是为 ROS 2 做贡献的一些最简单方法。您可以在 联系方式 page.

贡献代码

设置开发环境

要开始安装,您需要从源代码中安装;请按照以下步骤操作 源安装说明 您的平台。

发展指南

工作内容

我们确定了一些可由社区成员完成的任务:它们可按以下方式列出 在 ROS 2 资源库中搜索标有 "需要帮助 "的问题.如果您在清单上看到了您想做的事情,请在该项目上发表评论,让其他人知道您正在研究它。

我们还有一个标签,用于标注我们认为首次投稿者更容易获得的问题、 标为 "良好的创刊号".如果你有兴趣为 ROS 2 项目做出贡献,我们建议你先看看这些问题。如果您想扩大范围,我们欢迎您对任何开放问题(或您可能提出的其他问题)做出贡献,尤其是那些有里程碑标志的任务,这些任务将在下一个 ROS 2 版本中发布(里程碑将是下一个版本的 "crystal")。

如果您有修复错误或改进文档的代码贡献,请将其作为拉取请求提交到相关版本库。对于较大的更改,最好先讨论提议 在 ROS 2 论坛上 这样您就可以确定是否有其他人已经在做类似的工作。如果您的建议涉及更改应用程序接口,我们特别建议您在开始工作前讨论相关方法。

提交代码更改

代码贡献应通过拉取请求提交至 相应的 ros2 资源库.

我们要求所有投稿人遵守《世界人权宣言》中解释的做法。 开发者指南.

请务必 运行测试 因为大多数软件包都有测试,检查代码是否符合我们的风格指南。

成为核心维护者

ROS 2 维护人员确保项目取得总体进展。维护者的职责包括

  • 审查收到的代码贡献的风格、质量和与版本库/ROS 目标的整体契合度 2.

  • 确保 CI 继续保持绿色。

  • 合并符合上述质量和 CI 标准的拉取请求。

  • 解决用户提出的问题。

中的每个存储库 玫瑰2动情 各组织都有一组独立的维护者。成为其中一个或多个软件源的维护者只接受邀请,一般包括以下步骤:

  • 在过去的一年中,为知识库贡献了大量代码。

  • 在过去一年中,对提交到版本库的拉取请求进行大量审核。

大约每 3 个月,ROS 2 团队就会审查所有资源库中的贡献,并向新的维护者发出邀请。一旦邀请被接受,新维护者将被要求接受有关 ROS 2 资源库机制和政策的短期培训。培训结束后,新维护者将获得相应软件库的写入权限。