I am new to Ruby on Rails. I am very very pleased with it thus far. While the videos showing RoR in action were tremendously helpful, I am somewhat dissapointed by the available documentation. Most, if not all, of the functions and classes are not completely documented or exemplified. I realize that the documentation is rdoc-generated, but I was wondering if there was any effort underway to improve the quality and depth of the documentation. Thank you -v -- Posted via http://www.ruby-forum.com/. --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Ruby on Rails: Talk" group. To post to this group, send email to rubyonrails-talk-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org To unsubscribe from this group, send email to rubyonrails-talk-unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org For more options, visit this group at http://groups.google.com/group/rubyonrails-talk -~----------~----~----~----~------~----~------~--~---
vsharma wrote:> I am new to Ruby on Rails. I am very very pleased with it > thus far. > > While the videos showing RoR in action were tremendously > helpful, I am somewhat dissapointed by the available > documentation. > > Most, if not all, of the functions and classes are not > completely documented or exemplified. > > I realize that the documentation is rdoc-generated, but > I was wondering if there was any effort underway to improve > the quality and depth of the documentation. > > Thank you > > -vare you talking about http://api.rubyonrails.com ?... Because I think it''s pretty good. Anyway, you should really consider buying a rails book: http://www.rubyonrails.com/docs regards, rolando.- -- Posted via http://www.ruby-forum.com/. --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Ruby on Rails: Talk" group. To post to this group, send email to rubyonrails-talk-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org To unsubscribe from this group, send email to rubyonrails-talk-unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org For more options, visit this group at http://groups.google.com/group/rubyonrails-talk -~----------~----~----~----~------~----~------~--~---
Rolando Abarca wrote:> vsharma wrote: > >> I am new to Ruby on Rails. I am very very pleased with it >> thus far. >> >> While the videos showing RoR in action were tremendously >> helpful, I am somewhat dissapointed by the available >> documentation. >> >> Most, if not all, of the functions and classes are not >> completely documented or exemplified. >> >> I realize that the documentation is rdoc-generated, but >> I was wondering if there was any effort underway to improve >> the quality and depth of the documentation. >> >> Thank you >> >> -v >> > > are you talking about http://api.rubyonrails.com ?... Because I think > it''s pretty good. > Anyway, you should really consider buying a rails book: > > http://www.rubyonrails.com/docs > > regards, > rolando.- > >If there are specific parts of the documentation that you feel are lacking let us know. We can only improve things if we know what needs work. Matthew Margolis blog.mattmargolis.net --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Ruby on Rails: Talk" group. To post to this group, send email to rubyonrails-talk-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org To unsubscribe from this group, send email to rubyonrails-talk-unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org For more options, visit this group at http://groups.google.com/group/rubyonrails-talk -~----------~----~----~----~------~----~------~--~---
There is also the www.railsmanual.org which has some search functionality. -NSHB On 8/22/06, Rolando Abarca <rails-mailing-list-ARtvInVfO7ksV2N9l4h3zg@public.gmane.org> wrote:> > vsharma wrote: > > I am new to Ruby on Rails. I am very very pleased with it > > thus far. > > > > While the videos showing RoR in action were tremendously > > helpful, I am somewhat dissapointed by the available > > documentation. > > > > Most, if not all, of the functions and classes are not > > completely documented or exemplified. > > > > I realize that the documentation is rdoc-generated, but > > I was wondering if there was any effort underway to improve > > the quality and depth of the documentation. > > > > Thank you > > > > -v > > are you talking about http://api.rubyonrails.com ?... Because I think > it''s pretty good. > Anyway, you should really consider buying a rails book: > > http://www.rubyonrails.com/docs > > regards, > rolando.- > > -- > Posted via http://www.ruby-forum.com/. > > > >-- Kind regards, Nathaniel Brown Inimit Innovations Inc. http://inimit.com --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Ruby on Rails: Talk" group. To post to this group, send email to rubyonrails-talk-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org To unsubscribe from this group, send email to rubyonrails-talk-unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org For more options, visit this group at http://groups.google.com/group/rubyonrails-talk -~----------~----~----~----~------~----~------~--~---
vsharma wrote:> I am new to Ruby on Rails. I am very very pleased with it > thus far. > > While the videos showing RoR in action were tremendously > helpful, I am somewhat dissapointed by the available > documentation. > > Most, if not all, of the functions and classes are not > completely documented or exemplified. > > I realize that the documentation is rdoc-generated, but > I was wondering if there was any effort underway to improve > the quality and depth of the documentation. > > Thank you > > -v >Other people have the same opinion as you do, and those other people reside over at http://blog.caboo.se. You can find information about their (well-funded by now) documentation project at http://caboose.stikipad.com/documentation. It is a work in progress, but these are top-notch rails developers at the wheel of the thing, so you can expect at least SOMETHING good will come from them and their $15K bucks ;) Regards, Henning Kilset --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Ruby on Rails: Talk" group. To post to this group, send email to rubyonrails-talk-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org To unsubscribe from this group, send email to rubyonrails-talk-unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org For more options, visit this group at http://groups.google.com/group/rubyonrails-talk -~----------~----~----~----~------~----~------~--~---