From: James Britt <ruby@...>
Date: 2006-01-13T06:47:36+09:00
Subject: Re: Design contracts and refactoring (was Re: mathn: ugly warnings)

ara.t.howard@noaa.gov wrote:
> On Fri, 13 Jan 2006, James Britt wrote:
>

>
>>
>> But what will the user see from ri and rdoc?
> 
> 
> nothing.  i've found myself using them less and less - at this point i use
> them about once per month.  my feeling is that
> 
>   vi -o samples/*
> 
> is much more powerful.
>

For a certain subset of Ruby developers.

...

> my intent in posting this, btw, was just to bring attention to the fact 
> that
> i've found it useful and people who love docs and unit tests might 
> consider it
> as another weapon.

Oh, I agree.  I want to see more examples and tests included as well, 
but there needs to be some form of easily-accessible doc set to 
accompany with binary-only Ruby packages (e.g., the Windows "1-click").


James