For the record, the manuals are being worked on. :) They are in a sad state, to be sure.
--Jeremy On Dec 15, 2007 12:02 PM, Scott <[EMAIL PROTECTED]> wrote: > > On Dec 14, 11:25 am, Manfred Stienstra <[EMAIL PROTECTED]> wrote: > > On Dec 14, 2007, at 11:21, Sven Fuchs wrote: > > > > > I'd like to throw in, though, that although Rails has pretty good > > > resources for many topics, they are really hard to find sometimes when > > > you don't exactly know what to search for. > > > > You go to google, type in "ruby on rails", click on "documentation" > > and voila: > > > > http://www.rubyonrails.org/docs > > > > I think this lists a good number of resources to get you started. > > Manfred, that page is a mess, with links that don't work, > documentation more than 2 years old and references to sites (howtos > and manuals) that are incomplete or a complete mess. It's absolutely > impossible to know if any of the howtos are even relevant anymore > because there are no dates on anything and like August said, one of > the first manuals is how to migrate to rails 1.0?! > > On top of that, the really usefull documentation is scattered around > hundreds of different blogs which are extremely difficult to find > unless you know exactly what you're looking for. It's almost as if > finding documentation is the initiation you go through in order to > have the priviledge of using rails. We're moving on to rails 2.0 with > new conventions and new ways of doing things and yet new developers > are going to start from the pre-1.0 days and progress to rails 2.0 as > they stumble upon information. > > How is a new developer supposed to know that REST is the current > convention, or even explain why rails chose REST? I only found this > out because I just happened to watch DHH's keynote at the 2006 > railsconf. What about plugins that are outdated > (acts_as_authenticated or login_generator)? Or what different > pagination plugins are offered and how they're different, etc. > > There's just no way the current documentation situation is adequate. > > Scott > > > > > > Manfred > > > -- http://www.jeremymcanally.com/ My books: Ruby in Practice http://www.manning.com/mcanally/ My free Ruby e-book http://www.humblelittlerubybook.com/ My blogs: http://www.mrneighborly.com/ http://www.rubyinpractice.com/ --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Ruby on Rails: Core" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/rubyonrails-core?hl=en -~----------~----~----~----~------~----~------~--~---
