>
> I don't want to sound ungrateful... or rude... or whatnot, especially as
> Ruby is free.. but documentation seems to be a big problem* with ruby at
> the minute.

True, though improving.

>
> I have no idea what is changed in 1.8  I know it broke my app written in
> 1.6.6, which is cool (i expect that and expect to have to rewrite when a
> new version comes out).. and the fact that there is no complete
> documentation for 1.8 (or even for 1.6) is cool.. but a change log or
> something would be helpful.  I can't take advantage of cool new features if
> (a) I don't know what they are and (b) I don't know what they even were in
> the last version...
>
> What can we do, and how can I help...

Visit http://www.ruby-doc.org

"The ruby-doc.org Ruby documentation project is an effort by the Ruby community to provide complete and accurate documentation for
the Ruby programming language."

There are links there for a documentation bundle download, as well as online versions of the pickaxe book (AKA Programming Ruby), a
URL interface to querying both the pickaxe and ri, a list of known online documentation, and a list of available books.

If you want to pitch in, there is always a need for people who write stuff down and post it someplace public.  It can be hosted on
ruby-doc.org if you like (and that offer goes out to all in general; if you have something you would like to publish, but don't have
a site for it, talk to me about putting it on ruby-doc.org).

There is also a mailing list for discussion of ruby documentation efforts (see www.ruby-doc.org for info and list archive URL).

Hosting the change logs for the various Ruby version might be a good thing in itself, so I may add that to the site. Might be nice
if there were an RSS feed for that sore of thing.

James Britt


>
> Take Care,
>
> Mark