致laravel各位大佬 laravel說明文件提個意見

Phor發表於2021-03-04

每次看到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繼續發光發熱
讓我們們同行愛好者更簡單易懂的上手

本作品採用《CC 協議》,轉載必須註明作者和本文連結

相關文章