GoFrame
是开源的、免费的软件,这意味着任何人都可以为其开发和进步贡献力量。 GoFrame
的项目源代码目前同时托管在 github
(主库)和 gitee
(国内)平台上,两个平台的仓库保持即时的同步,代码贡献统一使用 github
主库。我们非常欢迎有更多的朋友加入到 GoFrame
框架的开发中来,您为 GoFrame
所做出的任何贡献都将会被记录到 GoFrame
的史册中。
贡献内容大概可以分为两类: 代码贡献 和 文档贡献。
一、代码贡献
1、哪里找到任务
1)需要帮助的issue
在主库 issue
中有很多打上 help wanted
标签的 issue
,这些都期望得到社区小伙伴们的贡献: 地址戳这里
2)单元测试覆盖率
具体请查看章节: 可维护性建设:单测覆盖率
2、代码贡献流程
- 首先
fork
一份仓库代码到自己的版本库中; - 在自己的版本库中新建开发分支并对代码做修改,随后提交修改到自己的版本库;
- 在自己的版本库中创建一个
pull request
,源分支选择自己的开发分支,目标分支选择主库的master
分支: https://help.github.com/en/articles/creating-a-pull-request - 提交
pull request
请求,随后等待由项目的开发作者对提交内容做code review
。如果pull request
长时间没有被code review
,可以主动跟进、找到团队成员提出code review
要求。审核通过之后你将成为GoFrame
框架的成员之一。 - 恭喜你,你的名字将永久地载入到
GoFrame
框架源代码的贡献列表中;
3、代码协作约定
- 所有源码文件、类型、方法都要有详尽的注释;
- 如果逻辑复杂的程序部分需要阐述实现思路;
- 所有的注释都使用英文阐述,不再使用中文;
- 新增的功能/模块必须要有单元测试,并且覆盖率达到
80%
以上;
二、文档贡献
1、官网WIKI完善
GoFrame
框架的文档主要集中在 WIKI
中,地址: https://goframe.org
大家在阅读文档的过程中,如果不太完善的地方,可以点击编辑页面帮忙完善。特别是组件、功能的使用示例,往往都可以补充上去。
2、社区文档贡献
在官网中有专门的社区文档贡献空间,大家均可以往里面添加文章,例如,框架的使用感悟、常见问题、项目分享等等。地址: GoFrame社区投稿
3、博客及视频教程
社区的小伙伴可以编写文章或者录制视频分享,方便社区其他小伙伴通过搜索引擎查阅到你的分享,便于相互学习,以及开源项目推广。
在文章中请保持统一的框架名称关键字: GoFrame
,请勿采用缩写名称。
三、其他帮助
任何帮助可联系 郭强 ,微信号 389961817
。我将为你提供必要的指导和帮助。