From: Ryan Davis <ryand-ruby@...>
Date: 2007-07-17T07:49:16+09:00
Subject: Re: graphing/charting application


On Jul 15, 2007, at 09:26 , Chad Perrin wrote:

> Is there some kind of rule that states that, when something like  
> RDoc is
> available, library developers are disallowed from producing good
> documentation?  I'm constantly frustrated by the fact that many  
> libraries
> figure a skeleton map of available methods constitutes  
> "documentation".

Is there some kind of rule that states that, when something is freely  
made available to the public, the users are disallowed from being  
polite? I'm constantly frustrated by the fact that many users figure  
a scathing comment in IRC or a mail to ruby-talk constitutes  
"constructive criticism".

Why do so many users never seem to bother to put in an ounce of  
effort in looking at something for every pound of effort the author  
puts into writing it in the first place?

It took me less than 60 seconds to download gruff, unpack it, and  
notice that there is over 92K(!!) of tests. PLENTY of live testable  
"documentation" right there. But instead of doing something like  
that, your sense of entitlement made you think the above paragraph  
was a good idea.

...Made slightly redundant by Gregory's replies, but I had to get it  
off my chest...