Hacker News Reader

If there’s one thing I hate about Laravel, it’s the docs. Some things are documented, arbitrary others aren’t; many APIs offer multiple aliases or equivalent ways to solve the same problem, and the docs use them interchangeably. Sometimes there’s multiple paragraphs for an obvious feature, but a single sentence for something complicated, and you’ll have to try for yourself to find out how it behaves.

View on HN

It's been interesting seeing several comments like this in the comments, since Laravel's docs may be one of the most highly-praised aspects of the framework. I suspect the divide may be that newer developers get everything they need explained in the docs in clear language, but the more advanced stuff requires some digging.

I use Laravel personally, and I've definitely seen both sides of this myself. For basic "happy-path" API reference, the docs are great. If I really need to understand how the framework is doing something, I pretty much always end up diving into the code. Unfortunately the heavy use of Facades can sometimes make it annoying to find the underlying code.

That’s fair in certain parts. I like the balance they struck (at the time at least) of not super in the weeds but not high level tutorial mode. A few things around their orm specifically were a little confusing or sparse at times if memory serves

Reply on news.ycombinator.com