分享｜EdgeX Foundry 社区贡献经验分享

关于 Copyright 版权所有

• EdgeX Foundry 的 License 为 Apache v2，所以，我们贡献的也要遵循其 License，尽量避免一些继承 License；
• 谁贡献的代码/项目，Copyright 就归属于谁，这个毋庸置疑，所以，你拥有次代码的 Copyright；
• 不仅是项目需要需要签署，每次的 commit 也需要 Signed-off，这是强制规范，否则 DCO 无法通过；
• 不管你是公司还是个人，都建议你签署名字，提升个人 IP；
• 当你引用了第三方代码，要尊重其作者，在你的代码中需要注明，且表示感谢。

如果写代码更容易被社区接受和 merge 合并？

• 删除未使用的代码：如果某些代码未在程序执行过程中使用的话，就应该删除；
• 删除无用的配置：只保留与你的项目相关的配置信息，不需要的应该删除；
• 删除注释代码：你用来测试的代码，加上注释行是不被允许和保留下来的，应该删除；
• 代码格式：为了便于阅读，代码缩进要符合相关开发语言的规范，即使你的代码可以正常运行，也需要保证一致性；
• 完整的注释：社区 更愿意 接受完整注释的代码，不仅是方便自己阅读，也方便其他采用你的代码的社区伙伴。

EdgeX 社区有严格的代码规范，并且很详细的做了说明

• 既然我们贡献的代码是 方便社区 的其他伙伴使用，那么这些示例代码就应该符合规范；
• 我们要按照社区其他贡献者那样，将我们的贡献以函数库的要求来编写和文档化；
• EdgeX 社区贡献手册：
  • 提交代码指南：Committing Code Guidelines
  • 贡献文档：Contributing Documentation
  • 贡献者流程：Contributor's Process
• 一定要遵守，否则无法被社区接受。

你可能是老程序员，写过无数代码，但是，我们还是需要致敬前辈

• 社区管理人员帮我们 review 代码时，很认真，很敬业，可以用一丝不苟来形容，他们真的每一行代码，每一个字符串都看过；
• 他们还会在 review 的过程中给出很好的建议，修改权完全在于我们，他们不强制；
• 他们还会提出很多疑问，大部分疑问都会给出合理的建议和方法；
• 社区大拿中，还有 年迈60多岁的老 coder，那些经验非常值得我们学习；
• 社区都是一些激情澎湃的人，我们对此加入这个社区感到非常荣幸。