参与其中

作为一个开源项目，我们欢迎并鼓励社区直接向Nav2提交补丁。在我们的协作开源环境中，提交变更的标准和方法有助于减少积极开发社区可能造成的混乱。 [待校准@1964]

本文档解释了如何参与项目对话，记录和跟踪错误和增强请求，以及向项目提交补丁，以便您的补丁将在代码库中快速被接受。 [待校准@1965]

参与其中

如果你有兴趣参与导航2，首先，欢迎!我们鼓励每个人都参与进来，从学生到初级开发人员，到高级开发人员和高管。从错误修复到功能开发、新算法和重构，每个人都有事情要做。 [待校准@1966]

所有ROS 2 TSC工作组都就小组工作日程表问题举行会议。在这里，您可以找到Navigation2工作组会议的日期和时间。确保您正在检查当地时区。从这个日历中，你可以将自己添加到活动中，这样它就会出现在你的谷歌日历上，并通过谷歌闲逛获得到电话的活动链接。我们鼓励每个有兴趣的人来参加会议，介绍你自己，你的项目，看看每个人都在做什么。 [待校准@1967]

此外， ROS论述是关注社区中发生的更大讨论和公告的好地方。这不是发布问题或寻求帮助的正确地方。请访问 ROS Answers 进行问答。 [待校准@1968]

如果你想贡献代码或错误，请参阅过程部分。 [待校准@1969]

随着时间的推移，对于有兴趣并在堆栈的某个领域表现出技术能力的开发人员，我们将开发人员提升到维护者的地位。这允许对我们受保护的分支机构的推送权限、第一审查者权限以及在关于和联系上获得您的名字。目前还没有一个明确的过程来成为一名维护者，但是如果你已经参与并贡献了几个月，你可能是一个很好的候选人，应该给列在关于和联系上的项目负责人发邮件。 [待校准@1970]

流程

在工作组会议中介绍自己之后 (推荐，不是必需的)，您就可以开始了!我们推荐一个典型的开源项目流程以及价值细节和透明度。如果你承诺了某件事并且需要撤回，那就说出来。我们都知道优先级会发生变化，并且会提高警惕，这样任务就可以进入任务的开放队列。 [待校准@1972]

过程简单如下: [待校准@1973]

为您希望看到的任何问题或功能创建票证。您不需要修复/实施所需的补丁，但这将很有帮助。报告错误也是一个有价值的贡献。 [待校准@1974]
如果票，或另一个现有票，你想工作，评论票声称所有权。它有助于此时如果你宣布战略和时间表规划目的其他人你周围工作。,更新票进展关键标记和任何建设性反馈维护者或其他用户。 [待校准@1975]
一旦完成任务出发完成，提交公关!请填写PR模板完全确保我们充分了解你的工作。此时，1 2评论员会看看工作给它一些反馈合并到代码库。用细微改变，单维护者可能合并后审查如果他们高兴，自行决定。实质变动应批准至少1维护者和其他社区成员。 [待校准@1976]

注意: 我们认真对待代码质量，并努力追求高质量和一致的代码。我们使用了ROS 2 ( ament_cpplint 、 ament_uncrustify 、 ament_cppcheck 等) 中提供的起毛和静态分析工具。所有PRs都内置在具有适当ROS分布的CI中，并通过一组单元和系统级测试 (包括静态分析) 运行。您可以在拉取请求中看到这些测试的结果。预计测试的功能开发将涵盖此工作。如果由于您的更改而必须更新任何文档，则应将其包含在您的请求中。 [待校准@1977]

许可

授权非常重要开源项目。它有助于确保软件继续条款下提供作者所需。 [待校准@1979]

因为大部分源代码是从其他ROS 1项目移植而来的，所以每个包都有自己的许可证。捐款应在该一揽子计划的主要许可下进行。全新的包装应该在 Apache 2.0 license 下提供。 [待校准@1980]

许可证告诉你什么权利你作为开发者，由版权持有人。重要贡献者完全理解许可权利同意他们。有时版权持有人不是贡献者，例如贡献者工作代表公司。 [待校准@1981]

如果由于某种原因Apache 2.0或BSD许可证不适合工作，请接触项目维护者和讨论问题或要求。我们可以考虑特别例外特殊工作合理 (我们不会接受任何许可证使得它不适合商业用途)。 [待校准@1982]

开发者认证 (DCO)

为了真诚地努力确保满足许可标准，Nav2鼓励遵循开发商原产地证书 (DCO) 流程。 [待校准@1984]

DCO是对开发商所做的每一项贡献的证明。在贡献的提交消息中 (在本文档的后面更全面地描述)，开发人员简单地添加了一个 Signed-off-by 语句，从而同意DCO。 [待校准@1985]

实际上，只需 “git commit-s-m” commit messsage就更容易了。“”。其中 -s 会自动添加。如果您忘记将它添加到提交中，很容易通过: git commit --amend -s 附加。 [待校准@1986]

当开发人员提交补丁时，贡献者有权根据许可证提交补丁是一种承诺。DCO协议如下图所示在http://developercertificate.org/. [待校准@1987]

Developer's Certificate of Origin 1.1

By making a contribution to this project, I certify that:

(a) The contribution was created in whole or in part by me and I
    have the right to submit it under the open source license
    indicated in the file; or

(b) The contribution is based upon previous work that, to the
    best of my knowledge, is covered under an appropriate open
    source license and I have the right under that license to
    submit that work with modifications, whether created in whole
    or in part by me, under the same open source license (unless
    I am permitted to submit under a different license), as
    Indicated in the file; or

(c) The contribution was provided directly to me by some other
    person who certified (a), (b) or (c) and I have not modified
    it.

(d) I understand and agree that this project and the contribution
    are public and that a record of the contribution (including
    all personal information I submit with it, including my
    sign-off) is maintained indefinitely and may be redistributed
    consistent with this project or the open source license(s)
    involved.