Issue #5412 has been updated by Eric Hodel. Overall this patch is good, but needs some small adjustments. The new additions to the top-level documentation should include a * even for blank lines. When you're referring to other methods they should not be surrounded by "+" or "<code>" so RDoc will link them. For example, use #compact instead of +compact+. I think there is too much duplication with the documentation of the individual methods for Creating Arrays and Accessing Elements sections. Could you trim this down to avoid the duplication? ---------------------------------------- Bug #5412: Array documentation http://redmine.ruby-lang.org/issues/5412 Author: Andrea Singh Status: Open Priority: Normal Assignee: Eric Hodel Category: DOC Target version: ruby -v: trunk As a contribution to the Mendicant University drive to enhance MRI documentation, I've tackled documentation of the Array class. I've amplified the general description of the Array class and highlighted some of the more commonly used instance methods. I've also edited some of the method-level code samples. -- http://redmine.ruby-lang.org