致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 协议》,转载必须注明作者和本文链接
Phor
《L03 构架 API 服务器》
你将学到如 RESTFul 设计风格、PostMan 的使用、OAuth 流程,JWT 概念及使用 和 API 开发相关的进阶知识。
《L02 从零构建论坛系统》
以构建论坛项目 LaraBBS 为线索,展开对 Laravel 框架的全面学习。应用程序架构思路贴近 Laravel 框架的设计哲学。
讨论数量: 15

支持,想起在几年前刚接触这个框架的时候,有部分的例子都感觉很异常,在定义的时候不是很清楚,导致看文档的同学们都深深的烦恼,

3年前 评论

小弟有幸翻译过几次,说一下我的观点,翻译的本意本来就是把英文变成中文,你这加上了例子,这违背了翻译的初衷。况且翻译的文档不可能做的面面俱到,解释每一个参数的。我觉得应该多一些老铁发发实战博客 :joy:

3年前 评论
deatil 3年前
Phor (楼主) 3年前

想法是有的,也是好的,只是这个要另外开一个文档,你可以来开头,然后有多少人一起贡献就是一回事了。

3年前 评论
fatrbaby

翻译不是写书。

3年前 评论
Phor (楼主) 3年前

5.1 开始看文档,一直到现在的 8.x,也从一个阅读者,成为了一个翻译者 :relaxed:

不得不说,这个想法确实很好,但是,官方文档是为了方便我们快速查阅,应该在另起一档,类似 wiki,里面有很多我们平时注意不到的骚操作,实用场景。

官方文档对刚接触这行的同学、甚至是初级小伙伴,看起来确实是很吃力的,当然也有部分同学能搞懂。

其实还有一个问题,就比如我最初看队列和任务调度的时候,看完文档,我确实知道了它是什么,也知道它怎么用,但在实际项目中我并没有用过它,因为我不知道它的使用场景是什么,什么时候能用,什么时候才适合用 :joy: :joy:

3年前 评论

好想法,新人看文档确实很吃力,真不是不愿意看,是看到很多地方懵逼

3年前 评论

file

以前我都不知道 * * * * *(cron 每分钟执行一次) 的意思 楼主现在也不知道。

加例子 造成文章太长 对于懂的人来说 是废话

百度一下: laravel任务调度使用 一堆例子

3年前 评论
颠倒的玉石

新手看确实会费劲。慢慢用的多了,多看看别人写的深入解析的文章就了解了。写的特别细致,写文档的人也费劲,慢慢的就不会有人写了。毕竟不是手把手的教,也没有费用

3年前 评论
Phor (楼主) 3年前
Epona

Laravel 的文档有些地方确实是差那么点意思。 对比Rails的话,Rails的文档就会生动很多,我个人建议加个类似

译者注 说明xxxxx

可能会好一些,当然直接翻译原文也没毛病就是了。

3年前 评论

怎么说呢 laravel 的文档定位只是一个工具 我是遇到问题才会去翻文档 我也大概知道文档可以帮我解决哪些问题

如果你想学习laravel 框架 想了解详细的实例 论坛有一系列的教程 有关于laravel框架核心话题的各种很好的文章
也有各类问题的解决方案和探讨
总而言之 laravel的官方文档只是框架的参考工具 不是最佳实践

3年前 评论

觉得可以加一些外部文章例子链接在某些地方。

3年前 评论

翻译工作最基本的就是要尊重原文。

3年前 评论
pigzzz (作者) 3年前
Phor (楼主) 3年前
小烦 3年前

如果一定要有人去做这件事情,那为什么不能是你

3年前 评论
Phor (楼主) 3年前
Fringe
3年前 评论
Phor (楼主) 3年前

讨论应以学习和精进为目的。请勿发布不友善或者负能量的内容,与人为善,比聪明更重要!