I've been using PHP for a really long time. The main point that attracted me to PHP was the manual, which is by all accounts excellent.

So I began trying to learn Rails in the last few weeks. While there are a number of decent, or even good, tutorials on various topics, the actual documentation seems to be lacking. I've been using http://api.rubyonrails.org/, but it seems to be very deficient. Not searchable and hard to navigate. Oh, and a large number of methods have no documentation at all. For example, the session has six methods, only one of which has anything more than an argument list.

Is there something more I'm missing? Because the time wasted searching all over God's Green Internet for answers to questions like "what does ynaqdh mean?" is getting to me.