August Lilleaas wrote: > Because of the reasons mentioned above. An API is a reference tool, > and has a tremendously steep learning curve if you don't know anything > about Rails. The API is indeed documentation, but it's not sufficient > for a beginner. So, the official documentation is no good for > beginners. That's my main concern. > > On Dec 14, 2:51 pm, Thijs van der Vossen <[EMAIL PROTECTED]>
August, I agree that a core doc team is an excellent idea. But it's also great that other sites would provide this too. That would mean that people could go to whatever site they find more easily(they are n00b's after all ;) ) or like better. Plus content could be copied back and forth if it was worthwhile and fit both styles. www.rubyonrails/docs is the probably the first place people look, and pointing at an API does look really bad. Maybe, starting something on that railsbeginner domain and hoping to get it moved to rails/docs(/beginner ?) or linked to from there would be a good way to get people interested. Especially as this has been a fairly well received post. PM once you know what you are doing with improving documentation. I'd like to get involved. -- Posted via http://www.ruby-forum.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 -~----------~----~----~----~------~----~------~--~---
