New Rails Version 3.0 Guides Online

Fri Jan 29 16:53:00 -0800 2010

I am going through and updating a lot of the guides for Rails. As I do each one, I will update this post.

Rails 3 has a lot of changes. Don’t be fooled, the core team has been hard at work for the last year ever since the Merb and Rails announcement.

You can think of Rails 3 as a massive refactoring and extraction project. The amount of spring cleaning is, to put it bluntly, phenomenal.

So as I go through each guide and update it, and it gets published, I’ll link to it here, so you can all follow along :) I would also like all the feed back in can get on these. You can email me, send me a tweet or comment here.

Getting Started with Rails

Getting started with Rails was, appropriately, the first guide that was updated. This was different enough that the version 2 guide simply did not work on Rails 3. You can also find all the code for the getting started guide at my Getting Started Code github repository.

Layouts and Rendering in Rails

Layouts and Rendering in Rails was the next guide updated. Again, a lot of changes in Rails 3, highlights on the HTML 5 implementation, handling of the new video_tag and audio_tag helper methods and a big gotcha on partial rendering (you’ll have to read the guide for all the juicy bits, but enough to say that a lot LESS local variables get magically defined in partials now.

Next Up

I am mid way the Action Mailer guide now that the code has been updated to the new API. Check back soon.

blogLater

Mikel

  1. James Healy Says:
    Thu Jan 28 22:51:02 -0800 2010

    Maybe it’s just me, but making rails 3 guides live seems like a recipe for confused newcomers. It’s virtually guaranteed that the guides they read won’t match the version of rails they’ve installed.

  2. Mikel Lindsaar Says:
    Thu Jan 28 23:34:52 -0800 2010

    @James, fair enough, but these guides refer to Rails 3.0 at the top and good for people who are looking, I also would like feed back on the guides for people who can…

  3. James Healy Says:
    Fri Jan 29 04:46:53 -0800 2010

    @Xavier ah, my bad. Thanks for pointing that out.

  4. Xavier Noria Says:
    Thu Jan 28 23:35:30 -0800 2010

    @James the ones in guides.rails.info are edge guides. They are built periodically from docrails. The official/stable guides live in guides.rubyonrails.org and are published with new Rails releases.

Leave a Reply