From: James Britt <james.britt@...>
Date: 2007-03-03T15:26:21+09:00
Subject: Re: [ANN] Ruby-doc.org search for your browser toolbar

James Edward Gray II wrote:
> On Mar 2, 2007, at 8:05 PM, James Britt wrote:
> 
>> Thanks to Greg Whiteley, ruby-doc.org has a slick new feature.
> 
> Forgive my subject change, but can I ask why the Core documentation now 
> includes most of the standard library as well?  I think this has hurt 
> it's browsibilty.

What's there is simply the output of running rdoc over the main source, 
as has always been the case.  There seem to have been changes in the 
source code or the .document files.

I'd prefer to see no distinction at all, but have the docs be clear on 
whether a given class/module/method is built-in, or requires 'requires' 
on something, and so on.    But, right now, the docs show, for example, 
  YAML methods as being built into core classes, such as Array. So there 
is all sorts of confusion.

However, this may be a topic better discussed on the ruby-core or 
ruby-doc  lists.

-- 
James Britt

"A language that doesn't affect the way you think about programming is 
not worth knowing."
   - A. Perlis