James Britt
3/3/2007 6:26:00 AM
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