Coming from a modest framework (CI) I must say that I like the Yii aproach but I find it very hard to put the pieces together in order to create a general idea about what goes where does what. The documentation refers too many objects and links too many pieces in one phrase which makes it almost scary for Yii beginners like me. I searched for a simple thing like how to add language strings or how to edit the default language and I landed here. If you look at the page you will notice about 50 links going to 50 pages but still, my answer is nowhere to be found or maybe I’m lost in so many page relations (it’s like the wikipedia). I think you have another comment in that page from another user like me.
Unfortunately I don’t know what to point as an improvement but I can definitely say that the documentation is very complex, scary and very hard to digest. At least for people starting up with Yii. Please have a look at CI’s documentation and read their pages about each thing in part. There is no LINK to NO Api etc. Each page tells you everything you need to know about something from start to finish, very simple explanations to approach new users very smoothly. Very well sectioned into “how to load”, “how to edit settings”, “Usage Examples (VERY important - this is the part where our brain understands best)”, “where should be used” and nothing else. Everything advanced should probably referenced at the end of the tutorial.
I had to google and look at videos, study the provided demos just to find out what is a component, I still don’t know that for sure but I’m making an idea.
In the very second proposition the author skipped the whole idea of making a documentation and jumped to api explaining and injected a url already. In the third, guess what, we’re referencing another page from the api and explaining it. This is more like an API documentation rather than a user documentation.
Once I start to master Yii, your guides will probably make sense and prove to be quite helpful but I’m not going anywhere at this moment. I’m left with way too many unlinked pieces about this framework.