From: Ruby Student Date: 2009-02-15T07:05:18+09:00 Subject: Re: Good GUI documentation --000e0cd212cc04943c0462e82cd6 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit On Sat, Feb 14, 2009 at 11:34 AM, David Masover wrote: > 7stud -- wrote: > >> Ruby Student wrote: >> >> >>> I want something simple or at least well documented. >>> >>> >> >> See the php docs for the best docs of any language I've encountered. >> Unfortunately, Ruby just shoots itself in the foot as far as the docs go. >> It doesn't matter how great a language is advertised to be--if the docs >> suck, the language sucks. >> >> > > I would turn that on its head. PHP has decent docs, I'll grant, but rdoc > isn't completely bad. And when something isn't documented, in Ruby, the > source is readable enough that I can usually find out what's going on -- in > PHP, it might not be so easy. > > Docs are nice, especially for newbies, but if the language sucks, the > language sucks, and no amount of documentation will save it. On the other > hand, if the language rocks, docs are a nice bonus, but a lot of it should > be self-documenting anyway. > > Thanks to everyone for their comments and recommendations.I greatly appreciate all suggestions and comments. -- Ruby Student --000e0cd212cc04943c0462e82cd6--