Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Open source version of the Rails Upgrade Handbook
branch: master
Failed to load latest commit information.
finals Remove .DS_Store files
output Remove .DS_Store files
pkg Remove .DS_Store files
src Book is now content-complete.
tasks Checkin
text First commit
9x7_Back_EN.psd Checkin
9x7_Front_EN.png Updates to text
9x7_Front_EN.psd Checkin
README.mdown Add more README bits
Rakefile Checkin
preamble.tex Checkin


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.