From: David Masover <ninja@...>
Date: 2009-02-15T01:34:42+09:00
Subject: Re: Good GUI documentation

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.