From: Gregory Seidman <gsslist+ruby@...>
Date: 2008-03-15T02:02:44+09:00
Subject: Re: How to Read Ruby API / Documentation :NUBY

On Sat, Mar 15, 2008 at 01:39:00AM +0900, 7stud -- wrote:
> You will have to get used to the fact that the Ruby docs are horrible.

The *free* Ruby docs leave something to be desired. The Pickaxe book is
pretty good in a lot of ways, and I've also gotten a lot of value out of
the O'Reilly Ruby Pocket Reference I won at RubyConf.

Beyond that, Foo.instance_methods.grep(/bar/) is your friend. Playing
around in irb is invaluable. I even look things up in ri occasionally. The
wealth of expertise available on this mailing list and on #ruby-lang on
freenode.net have also helped me a great deal. And Google is always your
friend.

Complaining that the free documentation for the free (and Free)
language/platform you're using leaves something to be desired is absurd.
Feel free to contribute better documentation if you think it's a good use
of your time. (Saying it's worth someone else's time but not your own is
the height of hypocrisy unless you're willing to pay money for that other
person's time.) Otherwise, use the other resources available to you.

--Greg