From: James Britt <james_b@...>
Date: 2005-10-14T15:16:28+09:00
Subject: Re: Why Write Ruby Docs?  (was Re: [SUMMARY] Text Image (#50))

James Edward Gray II wrote:
> I'm sorry, but the more I think about this, the more it bugs me...

Why?

> 
> On Oct 13, 2005, at 7:27 PM, James Britt wrote:
> 
>> Hosting documentation is trivial.
> 
> 
> You do this part, right?

Indeed.

> 
> You run ads on the site and this (http://www.rubystuff.com/ about.html) 
> also generates income for that service.

Yes.  Helps pay some of the bills.

> 
>> Getting people to write documentation is not.
> 
> 
> I do this part.  I've documented three standard libraries in the last  
> year.  ERb, Delegate, and Forwardable.

There are a few people writing core and stdlib docs on a semi-regular 
basis, but by and large, there are large parts of Ruby insufficiently 
documented.

> 
>> At least not, it seems, without offering financial renumeration.
> 
> 
> I haven't seen my check yet?!

Maybe after the bills get paid.

:)

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