From: James Britt <james_b@...>
Date: 2005-10-14T09:27:27+09:00
Subject: Re: [SUMMARY] Text Image (#50)

James Edward Gray II wrote:
> On Oct 13, 2005, at 6:39 PM, James Britt wrote:
> 
>> daz wrote:
>>
>>> James Edward Gray II wrote:
>>>
>>>> Gavin, that second link looks like ready to put online RDoc.  Any
>>>> reason we don't have it on ruby-doc.org?
>>>>
>>>>
>>> Possibly because James Britt at ruby-doc.org doesn't
>>> want to conflate 1.9 and 1.8.2 docs (?)
>>> In 1.8.2, Enumerator is an extension;
>>> in 1.9, it's a built-in class with (I think) added functionality.
>>> It would be nice if 1.9 rdoc could be hosted somewhere, though.
>>>
>>
>> There had been an older version on them on ruby-doc, though I think  
>> they got lost in the server shuffle.
>>
>> I can add them again, if there is sufficient interest.  But it  seems 
>> that they're a bit avant garde for most people who wouldn't  already 
>> have  them locally anyway.
> 
> 
> I see absolutely no reason not to make every last shred of  
> documentation available to the users of Ruby.  I say we document,  
> document, document until there is no library left to cover.

Hosting documentation is trivial. Getting people to write documentation 
is not.  At least not, it seems, without offering financial renumeration.

James

-- 

http://www.ruby-doc.org - The Ruby Documentation Site
http://www.rubyxml.com  - News, Articles, and Listings for Ruby & XML
http://www.rubystuff.com - The Ruby Store for Ruby Stuff
http://www.jamesbritt.com  - Playing with Better Toys