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 --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
