致laravel各位大佬 laravel说明文档提个意见
每次看到laravel更新,laravel china活跃!作为一个老PHP特别高兴,看到php还有市场,还有这么多同行继续!真好。
经常翻阅laravel文档,在这里想提几个问题,可能也是很多php程序员同样遇到的苦恼!
laravel在很多场景下拓宽了开发的视野!尤其是咱们说明文档的【综合话题】模块.
这里也出现了一个很大的弊端。
这里面有这么多的应用场景,作为一个说明文档,只是在乏味的说明,介绍各种参数,很多地方的介绍是有严重歧义的。
例如在调度模块,我刚看到这里,到现在我也不知道为什么
php artisan schedule:run ,不论我设置了调度频率是哪个参数,我的调度执行一次然后马上就退出
cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1
我按照各要求执行后,就报错
咱们翻译老铁们工作很辛苦,在这里先给诸位鼓励!
如果,在基于自己的见解,加入几个生动的小例子,把各种参数的介绍再给详细做完调研在基于真实的数据,做上说明,这才是真正的 laravel China 的官方权威说明!
咱们原封照抄,堆积放置,不但没有达到文档该用的说明教学意义,反而给很多从业者带来了很多不必要的麻烦!
说的有点多,总结我想说什么
说明文档缺少实际应用的好例子!
说明文档很多参数介绍不详细!
说明文档很多说明存在歧义!
希望咱们共勉,出精品,让作为PHP顶梁柱之一的laravel继续发光发热
让咱们同行爱好者更简单易懂的上手
PHP是世界上最好的语言 没有之一!
本作品采用《CC 协议》,转载必须注明作者和本文链接
推荐文章: