贡献代码
官网英文原文地址:http://dev.px4.io/starting-contributing.html
核心开发团队和社区的联系信息可以在下面找到。PX4项目使用了三个分支Git branching model:
我们尝试通过rebases保持一个线性的历史,避免Github flow。但是由于全球的开发队伍和快速的开发转移,我们会定期分类合并。
为了贡献新的功能,首先注册Github账户,然后fork仓库,创建新分支,加入你的改变,最后发送pull request。当它们通过我们的持续的综合测试,更新就会被合并。
所有的贡献必须在 BSD 3-clause license许可下进行,并且所有的代码在使用上不能提出任何的,进一步的限制。
提交与提交消息
请使用描述性的、多段落提交消息进行所有非平凡的更改。 也可以好好组织语言,使其能够在一行的总结中有意义,并且依然提供全面的细节。
Component: Explain the change in one sentence. Fixes #1234
Prepend the software component to the start of the summary
line, either by the module name or a description of it.
(e.g. "mc_att_ctrl" or "multicopter attitude controller").
If the issue number is appended as <Fixes #1234>, Github
will automatically close the issue when the commit is
merged to the master branch.
The body of the message can contain several paragraphs.
Describe in detail what you changed. Link issues and flight
logs either related to this fix or to the testing results
of this commit.
Describe the change and why you changed it, avoid to
paraphrase the code change (Good: "Adds an additional
safety check for vehicles with low quality GPS reception".
Bad: "Add gps_reception_check() function").
Reported-by: Name <[email protected]>
使用 git commit -s
来结束你的所有提交。 这将会添加签名 signed-off-by:
以您的姓名和电子邮件作为最后一行。
此提交指南是基于Linux内核和Linus Torvalds维护的其他项目的最佳做法。
测试飞行结果
飞行测试对于保证质量非常重要,请从microSD卡上传飞行日志到 Log Muncher,并在PX4 Discuss分享链接,附带书面飞行报告。
论坛和聊天
每周开发电话
PX4开发团队每周都会进行电话会议,同步进度。
- 时间: 周三 5PM CET, 11AM EST, 8AM PDT (subscribe to calendar)
- Uberconference: www.uberconference.com/lf-dronecode
- 电话: +1 415-891-1494
- 议程事先在PX4 Discuss公布
- 问题和PRs可能被标记为devcall来进行讨论