From: gsm.beamon@...
Date: 2006-10-19T23:05:14+09:00
Subject: Re: Why Class decls and API docs don't Match

Gavin Kistner wrote:
> a) You might want to post this rant/question to the rails mailing list
> instead of the Ruby mailing list for more appropriate exposure.
This issue pertains to Ruby not Rails. And, in my opinion, it's a
fundamental issue.
rdoc is a program which runs on any Ruby source.

You can't have a system in which, despite MBs of fancy-smancy HTML API
docs,
you only know what you know because you spent the minutes (hours, days)
playing
around in the source code to see what's what. Ruby -- the language --
needs to do 
better here.