如何做贡献
为Apache ServiceComb做贡献
您可以通过很多方式帮助ServiceComb成长为更优秀的微服务框架——非常欢迎伸出援手!
- 浏览文档,这样可以加深您对ServiceComb的了解,学习到知识,一旦发现文档写得不清晰或逻辑混乱的地方,请通知我们;
- 下载代码,试一试我们介绍的功能,看看它是否与您预想的一样工作;
- 分析源代码,如果希望了解更多技术细节,请在Gitter上提问,大家会尽快解答;
- 希望炫一把黑科技体现您的实力?看看我们的 issue tracker 吧,欢迎您承接Open状态的Issues和未完成的特性,提交PR,成为贡献者之一;
- 如果您接触 ServiceComb不久并且很希望帮助我们,您可以先从简单的任务入手,循序渐进,甚至成长为Committer;
- 如果在使用ServiceComb的过程中发现有功能无法满足您的需求或出现问题,请在Issues中记录,并Watch项目,这样一旦这个问题有进展,都会第一时间通知到您。
初次接触
有下面的方式加入ServcieComb社区:
改进文档
文档是用户了解Apache ServiceComb最主要的方式,也是我们最需要帮助的地方!
因此如果您对改进文档的质量感兴趣,不论是修订一个页面的地址、更正一个链接、以及写一篇更优秀的入门文档,我们都非常欢迎!
我们的文档大多数是使用markdown格式编写的,您需要同步我们的Website项目,直接在 github上编辑后提交PR即可。
如果发现了一个Bug或问题
请提交一个新的Issue在我们的issue tracker上,如果您能够提供一个JUnit测试用例来复现这个问题,那么我们就能够更快的解决它,例如已经有的例子,并且我们还能够持续的确认这个问题不会再次出现在未来的版本中。
编写代码
ServiceComb的所有项目都在 Github上,包含下面几个子项目:
项目名 | 项目介绍 | 语言 |
---|---|---|
Java Chassis | Java微服务框架(SDK) | Java |
Service Center | 服务注册和发现 | Go |
Saga | 微服务最终一致性解决方案 | Java |
Website | ServiceComb主站 | Markdown |
如果希望给ServiceComb提交代码,您需要从github上fork对应的项目至您的项目空间下,为您提交的代码创建一个新的分支,添加源项目为upstream,并提交PR,更详细的步骤可以参考这篇文档。