Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Open source version of the Rails Upgrade Handbook
Latest commit fdd27ad @jm Merge pull request #1 from uxp/file_cleanup
File cleanup


Rails 3 Upgrade Handbook

I wrote this handbook leading up to the Rails 3 release; now that we're at Rails 3.2.x, I figure it's time to release this information into the wild.


  • To render as intended, you need PrinceXML. If someone wants to translate it into some other usable format that doesn't require Prince for a nice PDF, then go for it. I'll merge that pull request immediately.
  • You'll also need a long-lost hacked version of Maruku (I added a bit so you could add CSS classes to Markdown elements). Again, if someone would like to hack it such that that's not needed, then please, please do. I'll merge it immediately.

How can I help?

  • Update it for 3.2! There are some bits that will require extra work and others that don't have the same upgrade path. Any fixing would be appreciated.
  • Help convert it to an actual Rails guide It'd be neat to convert it to Textile and get it integrated into the actual docrails guides for wider publishing.


Do whatever you want with it as long as you attribute me (Jeremy McAnally) somewhere. It's just common courtesy. :)

Something went wrong with that request. Please try again.