From: Pistos Christou <jesusrubsyou.5.pistos@...>
Date: 2006-03-10T00:06:31+09:00
Subject: Re: No documentation for modules on RubyForge?

Geoff Lane wrote:
> that don't show anything in 'ri'. I think having one place to turn for
> documentation is a good idea.

For "standard" Ruby, all I've ever needed is documentation for the core 
and stdlib, which is covered entirely by www.ruby-doc.org ("thank you" 
to the site maintainers and contributors!) and/or PickAxe.

As someone else already mentioned, when it comes to non-standard libs 
(modules, gems), I think developers expect (should expect?) that 
documentation and quality are a sort of "at your own risk" type of thing 
-- particularly with relatively young languages.  Indeed, anyone can 
release a gem on their own site or via rubyforge.org.  I'm no Perl 
veteran, but I suspect CPAN wasn't that good in its earliest days, and 
it took maybe a few years and a lot of community effort to mature into 
what it is today.

I do agree that a centralized location for documentation is a good idea, 
since it is what turned me onto Java years ago; I knew I could go to 
java.sun.com's documentation of the standard lib for reference, and 
didn't need to go elsewhere, except for examples and tutorials.

For now, ruby-doc.org serves me very very well.

-- 
Posted via http://www.ruby-forum.com/.