Welcome to the Ruby Standard Library Documentation collection, brought to you by the Ruby-doc project. Whether you are browsing online or offline, we hope that your use of Ruby's standard library will become more productive as a result of this effort.
Ruby-doc is a project dedicated to creating and collecting documentation on Ruby. You can find collections of articles and other resources at the website.
stdlib-doc is a RubyForge project that converts Ruby source code into this documentation you are looking at. It also tracks the status of the documentation effort; you can see some of that effort in the Status Report page.
Each package in the Ruby standard library (found in lib/ directory of the Ruby source code, or lib/ruby/1.x/ of a Ruby installation) has been run through RDoc and the results have been collected here.
ruby-doc volunteers and library authors add comments to the Ruby source code CVS, and it is those comments that RDoc captures for display in this collection. As there are many libraries and few volunteers, this is a long task. To get some idea of what we've done and what we haven't, we use the stdlib-doc project mentioned above, whereby each file has a documentation score. What you need to know is that
Because the source code comments go straight into Ruby's source-code repo, the only way to get up-to-date documentation is to use the latest Ruby code as a source. There are two important side effects here:
The ruby_1_8_7 branch of the Ruby source code is used to produce the documentation. So you will see the latest that Ruby 1.8.x has to offer, not the experimental 1.9.
The documentation itself has been created by Gavin Sinclair, William Webber, Lyle Johnson, James Edward Gray II, and library authors. Individual library files usually have code and documentation credits.
ruby-doc.org was created and is maintained by James Britt/Neurogami.
Gavin Sinclair wrote the software (ruby stdlib-doc.rb gendoc --all) to generate this webpage (thanks, Amrita!).
James Britt did some later hacking to bring some things up to date and to have it play nice with different Ruby versions.
Thanks to Dave Thomas for RDoc, without which this project would be impossible, and for Programming Ruby, which provided inspiration for documentation, as well as some actual text.