内容简介:为了鼓励促进更加有效积极的合作,Laravel 强烈鼓励使用 GitHub 的 pull requests,而不是仅仅报告缺陷,“缺陷报告”也可以通过一个包含失败测试的 pull requests 的方式提交。然而,如果你以文件的方式提交缺陷报告,你的问题应该包含一个标题和对该问题的明确说明,还要包含尽可能多的相关信息以及论证该问题的代码样板,缺陷报告的目的是为了让你自己和其他人更方便的重现缺陷并对其进行修复。记住,缺陷报告被创建是为了其他人遇到同样问题的时候能够和你一起合作解决它,不要寄期望于缺陷会自动
缺陷报告
为了鼓励促进更加有效积极的合作,Laravel 强烈鼓励使用 GitHub 的 pull requests,而不是仅仅报告缺陷,“缺陷报告”也可以通过一个包含失败测试的 pull requests 的方式提交。
然而,如果你以文件的方式提交缺陷报告,你的问题应该包含一个标题和对该问题的明确说明,还要包含尽可能多的相关信息以及论证该问题的代码样板,缺陷报告的目的是为了让你自己和其他人更方便的重现缺陷并对其进行修复。
记住,缺陷报告被创建是为了其他人遇到同样问题的时候能够和你一起合作解决它,不要寄期望于缺陷会自动解决抑或有人跳出来修复它,创建缺陷报告是为了帮你自己和别人走上修复问题之路。
Laravel 源码通过 Github 进行管理,每一个 Laravel 项目都有其对应的代码库:
- Laravel Application
- Laravel Art
- Laravel Documentation
- Laravel Cashier
- Laravel Cashier for Braintree
- Laravel Envoy
- Laravel Framework
- Laravel Homestead
- Laravel Homestead Build Scripts
- Laravel Horizon
- Laravel Passport
- Laravel Scout
- Laravel Socialite
- Laravel Website
核心开发讨论
你可以在 issue board 上提议新功能或者优化已有功能,如果是新功能的话请至少实现部分代码以便完成新功能开发。
你也可以在 LaraChat
的 Slack 小组的 #internals
频道讨论关于 Laravel 的 bugs、新特性、以及如何实现已有特性等。Taylor Otwell,Laravel 的主要维护者,通常在工作日的上午8点到下午5点(西六区或美国芝加哥时间)在线,其它时间也可能偶尔在线。
哪个分支?
所有的 bug 修复应该被提交到最新的稳定分支,永远不要把 bug 修复提交到 master
分支,除非它们能够修复下个发行版本中的特性。
当前版本中完全向后兼容的次要特性也可以提交到最新的稳定分支。
重要的新特性总是要被提交到 master
分支,包括下个发行版本。
如果你不确定是重要特性还是次要特性,请在 Slack 小组 LaraChat
的 #internals
频道咨询 Taylor Otwell
安全漏洞
如果你在 Laravel 中发现安全漏洞,请发送邮件到 taylor@laravel.com
,所有的安全漏洞将会被及时解决。
编码风格
Laravel遵循 PSR-2 编码标准和 PSR-4 自动载入标准。
PHPDoc
下面是一个有效的 Laravel 文档区块示例,注意到 @param
属性前面有两个空格,参数类型前有两个空格,最后是参数名称,也有两个空格:
/** * Register a binding with the container. * * @param string|array $abstract * @param \Closure|string|null $concrete * @param bool $shared * @return void */ public function bind($abstract, $concrete = null, $shared = false) { // }
StyleCI
如果你的代码格式不是很完美,不必担心, StyleCI 会在提交代码时自动为我们修正代码风格以保持和 Laravel 仓库代码一致,从而让我们更加专注于代码内容而非风格。
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持 码农网
猜你喜欢:- 多线程一 入门序言
- [ Laravel 5.7 文档 ] 序言 —— 新版特性
- [ Laravel 5.7 文档 ] 序言 —— 升级指南
- 如何向开源项目贡献代码
- SkyWalking Java 插件贡献实践
- 【2018中国数字化贡献人物】
本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们。
Dojo权威指南
拉塞尔 / 李松峰、李丽 / 机械工业出版社 / 2009-4 / 79.00元
通过使用Dojo这个工业强度的JavaScript工具箱,我们可以比使用其他任何Ajax框架更高效、更容易地创建JavaScript或Ajax驱动的应用程序和站点。 《Dojo权威指南》向读者展示了如何充分利用Dojo工具箱中包含的大量实用特性,以前所未有的效率开发出功能丰富、响应敏捷的Web应用程序。读者通过《Dojo权威指南》能够学习到创建复杂布局和表单控件(常见于高级桌面应用程序)的技......一起来看看 《Dojo权威指南》 这本书的介绍吧!