News for hackers. Stuff that matters.
Re:Rails 3 Has Great Documentation by jshen on Saturday August 28, 2010 @07:54PM (#1642692)
I actually prefer this format http://api.rubyonrails.org/. Everything is there, and I can use cmd-f to search for whatever. It's probably because I'm familiar with it, but that's probably why you like python's.
Re:Rails 3 Has Great Documentation by wwortiz on Saturday August 28, 2010 @08:09PM (#1642719)
Ctrl-f only works if you know what you are looking for though.
Re:Rails 3 Has Great Documentation by nex3 on Saturday August 28, 2010 @08:49PM (#1642782)
That's the difference between reference documentation and introductory documentation. You go to reference documentation when you want to look up the details of something you already know; you go to introductory documentation if you want to learn it for the first time.
Re:Rails 3 Has Great Documentation by wwortiz on Saturday August 28, 2010 @09:52PM (#1642892)
Okay sure, but how do you get from the introductory docs (which are far and wide, as well as lacking in quite a few areas) to reference documentation. I can see how ruby-doc can be a good resource but only for those that know the language and know what they should be looking for, even then though sometimes docs like python's are better references.
Re:Rails 3 Has Great Documentation by dasil003 on Saturday August 28, 2010 @10:53PM (#1642988)
Far and wide?

Just start with Rails Guides (http://guides.rubyonrails.org/). When you are somewhat familiar you can find details in the API docs (http://api.rubyonrails.org/).

Re:Rails 3 Has Great Documentation by jshen on Sunday August 29, 2010 @12:01AM (#1643100)
there are also two great books, the agile rails book, and the rails way. They will get you started, and may be 90% of what you need. The docs are good for the rest.

One thing though, we're comparing apples and oranges; the docs for a web framework vs the docs for a standard library. Are the django docs similar to the standard lib docs?

I'm not trying to dis python, I really like python and use it whenever I need to do mathy stuff with numpy and scipy. Most other things I do in ruby.

Re:Rails 3 Has Great Documentation by wwortiz on Sunday August 29, 2010 @12:46AM (#1643171)
The django docs are rather good and similar in many ways to python docs: http://docs.djangoproject.com/en/1.2/