Guys, tell me, please, do you have plans to improve API documentation? Now documentation is totally useless from my point of view. Google searches much better than your own documentation search. Here keywords that does not return any results: “dropDownList”, “where”, “submitButton”, “updateAll”, “batchInsert” etc. End even if I search deeper it returns strange not related results. For example"dropDownList" search returns “yii\widgets\ListView” instead of ActiveField, “batchInsert” returns " yii\db\BatchQueryResult" instead of Command. It’s not working at all. And even if I somehow find documentation about activeListBox it looks like this:
Wow! Issue since April and nothing changed. Now I see why Yii have questions like “Is Yii dead?”. Maybe it’s not, but sure looks like dead or at least zombie.
You still did not answer my question. Why Yii team switched to this documentation version if it’s not working and no one have time to fix it? Issues about overflow bugs since April. That tells a lot, how long no one can really use documentation. And previous version was working and quite good.
The new docs are working, there are just a few bugs with it. We have a lot of stuff to do so priority was on fixing the forum for me. If you want to help fix the documentation, I invite you to take a look at the code. Yii lives from the community contributions, if you see something you want to have fixed or changed, you can help us getting it fixed with not much effort.
Searching for methods works on the new website, you just have to prefix the search term with . or ::, e.g. .save(). You can still use the old docs if you want:
You should be glad that there are issues created in the first place
I am amazed, and very thankful! that the small Yii team not only manages to keep Yii 2 afloat, but also drives it forward.
It is incredible that the team also has managed to write a new website from scratch!
There are so many small cogs that needs to fit with each other, you have no idea: front page, news section, wiki, user management, comment functionality, responsive design, …
And, yes: a small part of that is the Yii guide and the API docs. It works, but - as you noticed - still have some outstanding issues.
The new site is the result of many, many heroic deeds over a long period of time.
So, I think, lots of kudos should be sent to the Yii team!
Edit:
If you wonder whether or not Yii is dead, just check out the commit activity here:
I have added HTTP caching to the API that returns the method and class information for the search. Maybe that makes the search work better on slow connections. But it does not work as expected in firefox. Works for me in Chrome though. Which browser are you using @DMGPage?
I have fixed another issue where on slow connections the API docs result will show results for the first typed character (which is most likely empty) instead of the final search query.
@DMGPage I hope this solves the issues you are seeing with the search. please try again!
