贡献
介绍
Fuel是一个社区驱动的框架,并向任何自认为能改善它、或为其添加新特性使其更上一层楼的人开放。有许多形式可以做到这一点,从写教程、编写并发布组件,到贡献Fuel官方部分(Core, Orm, Docs等等)。
贡献代码
当遇到bug,或看到问题清单中你能解决或已解决的问题时,你可以使用GitHub发送拉取请求(pull request)。当你请求拉取时,根据你所在分支的版本不同,接下来的步骤可能有所不同:
-
此时此刻我使用的发布版本是否还受支持?
如果不支持,升级到最新版本,看看bug还在不在。 -
bug在新版本中是否还有?
如果还有,升级到当前开发分支,看bug是否已修复。 -
如果未修复,将当前开发分支checkout到你本地仓库。
$ git checkout -b 1.9/develop origin/1.9/develop
-
修复bug,并commit到本地仓库。
使用描述性的、易于理解的commit消息,并确保你确实修复了这个问题。
$ git commit -m "This is my awesome description."
-
将修改Push到你的GitHub账号
$ git push
-
请求拉取
在你使用的同一分支,请求拉取(= 当前开发分支)。 使用"update commit range"接口来将你导向正确的分支。 拉取请求只有在“当前发布版本的开发分支(1.9/develop)”才会被接受。 -
你的传说即将开始
你的请求一旦被合并,会即刻荣登光荣榜。
在 Github 上可查看关于这个流程的更为详细的说明。
非bug贡献
非bug贡献是指贡献新特性,最优化与其他修改。所有这些请求必须基于最新开发分支。所以要先拉取1.9开发分支,修改其并请求官方拉取。
对于大量与/或完整的新特性,或需要花些时间才能完善的特性,明智的做法是设置一个单独的特性分支。通过邮件联系核心开发人员,或在IRC上讨论是否执行这个修改。