Yii is one of the best PHP frameworks nowadays, with lot of cool features, and as I see its development every day is getting better. Nothing is perfect so also Yii has some weak points and probably the weakest point is its documentation. Source code documentation is quite precise and well structured, but with the user documentation you can not do much more than the basic blog app. Therefore most of the programming efforts require intensive forum searching and or finding how the things work my way. This is very slow and time consuming task so I would really appreciate if on of the priorities for future development would be improving it.
To suggest some key parts:
Improve the structure of user documentation. Especially cookbook contains a lot of useful information that could be part of the official documentation, but has almost no structure.
Improve the coverage of documentation over all framework, e.g. “conventions” part of docs is only very simple compare to for example Akelos framework (http://akelos.org/Akelos_Framework_Developer_Coding_Style_Guide.pdf)
Prado framework has a very helpful thing and it are the Control demos (http://www.pradosoft.com/demos/quickstart/?page=Controls.Standard). This is what saved me a lot of time while learning Prado. If the framework will be developed directly with it's demos, it can help not only as practical examples, but also in its testing process.
What do you think, is it possible and worthy to focus on this?