小伙伴们来一起共建FISCO BCOS，当你老了可以给孙子吹吹牛！

FISCO BCOS是完全开源的金融级联盟链底层技术平台，由金链盟开源工作组通力打造。

 

开源工作组成员包括微众银行、腾讯、四方精创、深证通、华为、亦笔科技、神州信息、博彦科技和越秀金科等金链盟成员机构。

 

代码仓库：

 

https://github.com/FISCO-BCOS/FISCO-BCOS  

 

对平台感兴趣可以star我们。欢迎各路大神一展所长，积极参与建设，为平台添砖加瓦。

 

FISCO BCOS下属40余个项目，不同项目上手难度各不相同，代码风格、修改规范等也略有差异。

 

如果你想为FISCO BCOS做出贡献，这里有一个简单的列表可供参考：

 

用的不爽，自己不想改 →提issues

 

程序可能有bug →提issues

 

文档没看懂，不知道怎么改 →提issues

 

文档有一些笔误，我想顺手改掉 →通过网页修改文档 

 

代码有值得优化的地方 →提交pr

 

我自己基于FISCO BCOS做了新的特性，想贡献到项目中 →提交pr

 

我很牛，我开发了一个FISCO BCOS的新项目→联系社区人员

 

提issues

 

当你在体验/使用过程中遇到问题，需要联系开发者对问题进行确定，或想要反馈优化建议，可以通过该项目的issues界面发起issues。

 

 

issue可跟踪，可复现。你提出的每一个bug ，都会沉淀下来，为那些和你遇到同样 bug 的人提供帮助。

 

具体提交issue方式可参考以下步骤：

 

 前期准备 

 

创建GitHub账号并登录该账号

 

 操作演示 

 

打开FISCO BCOS平台的issues界面，此处可参考链接：

 

https://github.com/FISCO-BCOS/FISCO-BCOS/issues

 

 

 

在title栏中描述问题类别，如：xxx-bug；在comment中详细描述您遇到的问题。

 

如果您是第一次对该项目提issues，可以查看右侧的contributing guidelines。

 

提issues Tips 

 

检索问题是否已经存在：高效解决问题，节省大家的时间，我们建议你在发起issues前，先通过官方文档，或issues界面进行搜索，定位是否有和您相同的问题出现过。

 

清楚描述问题：尽可能地减少沟通成本，我们期望你提交的issue能包含以下内容：使用明确的标题、使用的项目版本、使用的操作系统，出现问题的事实形式，出现问题时程序的log。

 

解决流程：项目维护人员会根据您提出的问题，给该issues打标签，您可以根据工作人员的回复，在指定路径体验修复该问题后的软件版本。当该issues标记为resolved后，如果您的问题已经解决，可以选择关闭该issues。

 

通过网页修改文档

 

查阅FISCO BCOS文档时，如发现有描述错误的地方，你可以通过网页来对文档进行修订。

 

 前期准备 

 

创建GitHub账号并登录该账号

 

适用场景 

 

修改已有文档内容

 

对已有pr进行修改

 

 操作演示 

 

  场景1 ：修改已有文档内容

 

以修改[使用手册/节点准入]文档为例，对提pr步骤进行说明。

 

https://fisco-bcos-documentation.readthedocs.io/zh_CN/release-2.0/docs/manual/node_management.html

 

修改示例如下图所示：你发现文档中输出+++日志部分的描述，替换成输出带有"+++"的日志的描述更准确。

 

 

修订操作请看演示：

 

https://mp.weixin.qq.com/s/RjlJZZ4RwtEDV33KBEoRNQ

 

(点击链接查看完整视频）

pr合入后，你会收到电子邮件通知。

 

  场景2：对已有pr进行修改

 

1.打开原有pr页面；

 

2.点击`Files changed`进行页面跳转，再点击铅笔状图标；

 

 

3.进行修改；

 

4.下拉至页面结束处，如选择将本次修改内容提交到原有pr（默认第一项），可直接点击`Commit changes`按钮，修改完成；

 

 

5.如选择将本次修改内容新建pr，点击第二项后将跳转页面，参照场景1的步骤继续操作。

 

6.提交完毕如下图所示，等待审核

 

 

提交pr

 

感谢你能将自己的代码贡献到FISCO BCOS中，更为详细的协作方式，大家可以参考《揭秘FISCO BCOS开源项目开发协作》，这里将介绍基本的pr步骤。

 

 适用场景 

 

当你基于FISCO BCOS的某个版本，与开发者沟通后，已经完成基于该版本新特性的开发，或bug修复、自测。

 

 前期准备 

 

创建GitHub账号并登录该账号(同上述过程一致)

 

使用格式化工作，确保代码通过自动化检测

 

 操作演示 

 

https://mp.weixin.qq.com/s/RjlJZZ4RwtEDV33KBEoRNQ

 

(点击链接查看完整视频）

 

 FISCO BCOS pr合并流程 

 

FISCO BCOS的项目中均配置有自己的自动化测试，你的pr提交后，请耐心等待自动化测试完成(半小时之内)。

 

同时，你需要保证所有的单元测试时正确，合入的代码均可以在目前支持的平台上编译、执行成功，且提交的代码满足该项目的风格规范。

 

pr提交后，请耐心等待项目维护者进行Review。

 

一般来说，提交的pr会在两个工作日内进行review，项目维护者在review过程中提出一些修改建议。

 

当修改完成后，项目维护者会将该pr标记为approve，你将会在你的GitHub邮箱中收到一封邮件。

 

当收到两个approve后，该pr将会被合并。

 

一旦pr被合入，你将成为社区贡献者，登上社区贡献者荣誉榜（点击阅读原文查看榜单），并且可获得社区周边专属纪念品。

 

欢迎大家积极参与共建FISCO BCOS。