致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 协议》,转载必须注明作者和本文链接
支持,想起在几年前刚接触这个框架的时候,有部分的例子都感觉很异常,在定义的时候不是很清楚,导致看文档的同学们都深深的烦恼,
小弟有幸翻译过几次,说一下我的观点,翻译的本意本来就是把英文变成中文,你这加上了例子,这违背了翻译的初衷。况且翻译的文档不可能做的面面俱到,解释每一个参数的。我觉得应该多一些老铁发发实战博客 :joy:
想法是有的,也是好的,只是这个要另外开一个文档,你可以来开头,然后有多少人一起贡献就是一回事了。
翻译不是写书。
从
5.1
开始看文档,一直到现在的8.x
,也从一个阅读者,成为了一个翻译者 :relaxed:不得不说,这个想法确实很好,但是,官方文档是为了方便我们快速查阅,应该在另起一档,类似
wiki
,里面有很多我们平时注意不到的骚操作,实用场景。官方文档对刚接触这行的同学、甚至是初级小伙伴,看起来确实是很吃力的,当然也有部分同学能搞懂。
其实还有一个问题,就比如我最初看队列和任务调度的时候,看完文档,我确实知道了它是什么,也知道它怎么用,但在实际项目中我并没有用过它,因为我不知道它的使用场景是什么,什么时候能用,什么时候才适合用 :joy: :joy:
learnku.com/laravel/wikis
好想法,新人看文档确实很吃力,真不是不愿意看,是看到很多地方懵逼
以前我都不知道
* * * * *
(cron
每分钟执行一次) 的意思 楼主现在也不知道。加例子 造成文章太长 对于懂的人来说 是废话
百度一下: laravel任务调度使用 一堆例子
新手看确实会费劲。慢慢用的多了,多看看别人写的深入解析的文章就了解了。写的特别细致,写文档的人也费劲,慢慢的就不会有人写了。毕竟不是手把手的教,也没有费用
Laravel 的文档有些地方确实是差那么点意思。 对比Rails的话,Rails的文档就会生动很多,我个人建议加个类似
可能会好一些,当然直接翻译原文也没毛病就是了。
怎么说呢 laravel 的文档定位只是一个工具 我是遇到问题才会去翻文档 我也大概知道文档可以帮我解决哪些问题
如果你想学习laravel 框架 想了解详细的实例 论坛有一系列的教程 有关于laravel框架核心话题的各种很好的文章
也有各类问题的解决方案和探讨
总而言之 laravel的官方文档只是框架的参考工具 不是最佳实践
觉得可以加一些外部文章例子链接在某些地方。
翻译工作最基本的就是要尊重原文。
如果一定要有人去做这件事情,那为什么不能是你
提问的智慧《社区使用指南》