贡献

在你开始为ROS 2项目做贡献之前，要记住几件事。 [待校准@149]

原则 [待校准@150]

  • 尊重之前发生的事情 [待校准@151]

    ROS已经存在了十多年，并被开发人员和世界各地使用。在做出贡献时保持谦虚的态度和开放的心态。 [待校准@152]

  • 尽早使用开放机器人 [待校准@153]

    • 开放机器人是ROS社区的守门人和倡导者。在设计阶段依靠他们的专业知识和技术判断。 [待校准@154]

    • 尽早与开放机器人技术和社区开始讨论。长期的ROS贡献者可能对大局有更清晰的认识。如果你实现了一个特性并发送了一个拉取请求，而没有先与社区讨论，你就冒着被拒绝的风险，或者你可能会被要求在很大程度上重新考虑你的设计。 [待校准@155]

    • 在开始实施之前，打开问题或使用话语将一个想法社会化通常是可取的。 [待校准@156]

  • 尽可能采用社区最佳实践，而不是临时流程 [待校准@157]

    在开发和贡献时，考虑一下你的最终用户的体验。避免使用并非所有人都能访问的非标准工具或库。 [待校准@158]

  • 把社区作为一个整体来思考 [待校准@159]

    想想大局。有开发人员用不同的约束来构建不同的机器人。ROS需要满足整个社区的要求。 [待校准@160]

您可以通过多种方式为ROS 2项目做出贡献。 [待校准@161]

讨论和支持 [待校准@162]

为ROS 2做出贡献的一些最简单的方法包括参与社区讨论和支持。你可以在 Contact 页面上找到更多关于如何参与的信息。 [待校准@163]

贡献代码 [待校准@164]

设置您的开发版本环境 [待校准@165]

首先，您需要从源文件安装; 跟随 the source installation instructions 为您的平台。 [待校准@166]

做什么 [待校准@168]

我们已经确定了许多社区成员可以完成的任务: 它们可以被列在 searching across the ROS 2 repositories for issues labeled as "help wanted" 中。如果你在清单上看到一些你想做的事情，请对这个项目发表评论，让其他人知道你正在调查它。 [待校准@169]

我们也有一个问题的标签，我们认为对于首次贡献者， labeled “good first issue” ，应该更容易获得这些问题。如果您有兴趣为ROS 2项目做出贡献，我们鼓励您先看看这些问题。如果您想扩大网络，我们欢迎对任何未解决的问题 (或您可能提出的其他建议) 做出贡献，特别是具有里程碑意义的任务，表明它们是下一个ROS 2版本的目标 (里程碑将是下一个版本的代号e。g. 'crystal')。 [待校准@170]

如果您有一些可以修复错误或改进文档的代码，请将其作为请求提交到相关仓库。对于更大的变化，在你开始工作之前讨论提议 on the ROS 2 forum 是一个好主意，这样你就可以确定其他人是否已经在做类似的事情。如果您的建议涉及对api的更改，特别建议您在开始工作之前讨论该方法。 [待校准@171]

提交您的代码更改 [待校准@172]

代码贡献应通过向 the appropriate ros2 repositories 提出请求来实现。 [待校准@173]

我们要求所有贡献者遵循 the developer guide 中解释的实践。 [待校准@174]

请确保您的代码更改是 run tests 的，因为大多数包都有检查代码是否符合我们的风格指南的测试。 [待校准@175]

成为核心维护者 [待校准@176]

ROS 2维护人员确保项目总体上取得进展。维护人员的职责包括: [待校准@177]

每个仓库在 ros2 and ament 组织单独的维护者。成为维护一个或多仓库是邀请过程，一般涉及以下步骤: [待校准@182]

大约每3个月，ROS 2团队将审查所有仓库中的贡献，并向新的维护人员发出邀请。一旦邀请被接受，新的维护人员将被要求通过一个关于ROS 2仓库的机制和政策的简短培训过程。培训过程完成后，新的维护人员将被授予对适当仓库的写访问权限。 [待校准@185]