From: Chad Perrin <perrin@...>
Date: 2007-07-17T09:05:31+09:00
Subject: Re: graphing/charting application

On Tue, Jul 17, 2007 at 07:49:16AM +0900, Ryan Davis wrote:
> 
> 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".

Is there some kind of rule that states that everyone who takes note of
what I said has to blow it out of proportion, assign intent to it that
wasn't present, and generally try to put words in my mouth?


> 
> 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.

Lay off the caffeine.  You're assuming an awful lot.


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

You should have sat on it.

-- 
CCD CopyWrite Chad Perrin [ http://ccd.apotheon.org ]
Thomas McCauley: "The measure of a man's real character is what he would do
if he knew he would never be found out."