When I learned Cocoa back then I really liked the API reference because every method had a "see also" section that gave me a link to methods that had a similar goal in mind. Think of shift/unshift, String#start_with/String#end_with. They somehow belong together but you have to find them first. A link would help a lot.
BTW, some methods do have a "see also" link, see: http://ruby-doc.org/core-1.9/classes/Enumerable.src/M003045.html
When I learned Cocoa back then I really liked the API reference because every method had a "see also" section that gave me a link to methods that had a similar goal in mind. Think of shift/unshift, String#start_with/String#end_with. They somehow belong together but you have to find them first. A link would help a lot.
BTW, some methods do have a "see also" link, see: http://ruby-doc.org/core-1.9/classes/Enumerable.src/M003045.html