mirror of
https://gitee.com/dromara/easy-es.git
synced 2025-12-06 17:18:57 +08:00
1 line
7.1 KiB
JavaScript
1 line
7.1 KiB
JavaScript
(window.webpackJsonp=window.webpackJsonp||[]).push([[41],{360:function(s,t,a){"use strict";a.r(t);var e=a(6),r=Object(e.a)({},(function(){var s=this,t=s.$createElement,a=s._self._c||t;return a("ContentSlotsDistributor",{attrs:{"slot-key":s.$parent.slotKey}},[a("p",[s._v("欢迎您加入和我们一起贡献Easy-Es,让这个项目变的越来越好。")]),s._v(" "),a("h2",{attrs:{id:"要求"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#要求"}},[s._v("#")]),s._v(" 要求")]),s._v(" "),a("p",[s._v("社区有很多童鞋愿意贡献这个项目,如果你想参与开发,成为committer,有以下要求:")]),s._v(" "),a("ul",[a("li",[a("p",[s._v("需要对开源有热情,技术扎实,有一颗用爱发电的心。")])]),s._v(" "),a("li",[a("p",[s._v("需要有一定空余时间能参与开发和阅读源码。")])])]),s._v(" "),a("h2",{attrs:{id:"如何加入开发团队"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#如何加入开发团队"}},[s._v("#")]),s._v(" 如何加入开发团队")]),s._v(" "),a("p",[s._v("首先你需要加入Easy-Es的社区群,如何加入请参考"),a("RouterLink",{attrs:{to:"/pages/kd129d/"}},[s._v("加入社区讨论")]),s._v(",然后私聊我,表示有意成为开发者。")],1),s._v(" "),a("p",[s._v("我会把你拉入开发者团队。")]),s._v(" "),a("h2",{attrs:{id:"如何认领任务"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#如何认领任务"}},[s._v("#")]),s._v(" 如何认领任务")]),s._v(" "),a("p",[s._v("我会不定期的在开发者团队群里push出一些issue,采用自己认领的方式。")]),s._v(" "),a("p",[s._v("在相关issue下回复“认领”就可以了,不用在群里回复。如果已经有相关人员认领了,请不要重复认领。")]),s._v(" "),a("h2",{attrs:{id:"提交pr"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#提交pr"}},[s._v("#")]),s._v(" 提交PR")]),s._v(" "),a("p",[s._v("Easy-Es的PR统一在Gitee平台上进行提交,如果你不知道如何提交PR,可以在Gitee平台里去学习。这里不作说明。")]),s._v(" "),a("p",[s._v("提PR有以下注意点。")]),s._v(" "),a("ul",[a("li",[s._v("fork后切换到"),a("code",[s._v("feature")]),s._v("分支,请以这个分支为开发基准。")]),s._v(" "),a("li",[s._v("所有的PR提交到"),a("code",[s._v("feature")]),s._v("分支,这个分支为开发分支。")]),s._v(" "),a("li",[s._v("如果你作了功能性的变动,请带上你的测试用例,测试用例规范可以参考之前的测试用例。")]),s._v(" "),a("li",[s._v("所有的PR必须关联至少一个issue,如果没有相关issue,请自行创建一个。")]),s._v(" "),a("li",[s._v("正式提交PR之前,请确保所有的测试用例都通过。")]),s._v(" "),a("li",[s._v("提交信息,均要符合要求,下面有讲述。")])]),s._v(" "),a("h2",{attrs:{id:"注释以及comment的要求"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#注释以及comment的要求"}},[s._v("#")]),s._v(" 注释以及Comment的要求")]),s._v(" "),a("p",[s._v("在文件头上,一定得有相关头注释信息,请按照规范,如下所示:")]),s._v(" "),a("div",{staticClass:"language-java line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-java"}},[a("code",[a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("/**\n * 这是你对这个类的描述,如比较长,多行也行\n * @author 老汉\n * @since 2.6.4\n */")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("YourClass")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n\t"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br"),a("span",{staticClass:"line-number"},[s._v("7")]),a("br"),a("span",{staticClass:"line-number"},[s._v("8")]),a("br")])]),a("p",[s._v("相关重要代码,为了保证阅读性,也请加上必要的注释, 并尽量遵循阿里巴巴代码开发规约")]),s._v(" "),a("p",[s._v("提交的时候comment也要按照规范来填写:")]),s._v(" "),a("div",{staticClass:"language- line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-text"}},[a("code",[s._v("#bug/future/enhancement/ #issue号 这是你issue的中文描述\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("举例:")]),s._v(" "),a("div",{staticClass:"language- line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-text"}},[a("code",[s._v("enhancemnet #I595MU 在slot的元数据里增加每个组件执行的耗时和是否成功结果\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("h2",{attrs:{id:"写代码时要注意的点"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#写代码时要注意的点"}},[s._v("#")]),s._v(" 写代码时要注意的点")]),s._v(" "),a("p",[s._v("开源框架的代码质量的要求会比较高,不仅是实现那么简单,还要考虑到各个环境的兼容性,优雅性和可读性。")]),s._v(" "),a("p",[s._v("所以在写代码时要多想一下。我相信,高标准高要求才能塑造一个优秀的框架, 这对您未来的技术成长也会非常有帮助。")]),s._v(" "),a("p",[s._v("在代码合并时,我会在PR下面给出修改意见,可能会比较苛刻,吹毛求疵。请大家谅解,完全是针对代码质量而不是针")]),s._v(" "),a("p",[s._v("对谁。开源项目要想长久发展,代码质量肯定是要严格把控的,否则这么多开发者,人手一套风格,最终将难以维护。")]),s._v(" "),a("h2",{attrs:{id:"我想对committer说的话"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#我想对committer说的话"}},[s._v("#")]),s._v(" 我想对Committer说的话")]),s._v(" "),a("p",[s._v("熟读代码+完成一个issue并合并到master分支的时候,我会邀请你成为LiteFlow的Committer,通常会在发版前统一邀请。")]),s._v(" "),a("p",[s._v("虽然原则上只需要完成一个issue,issue本身难易程度也有区别,但我希望作为贡献者的你不要满足只提交一个issue,希望")]),s._v(" "),a("p",[s._v("你能成为长期的Committer,来一起参与LiteFlow这个框架的迭代和发展和决策讨论中。只有这样,开源框架才能发展的更")]),s._v(" "),a("p",[s._v("加蓬勃,开源也会作为你成长和技术提高的途径。")])])}),[],!1,null,null,null);t.default=r.exports}}]); |