Add some more documentation to the upgrade guide

Summarize the gotchas encountered when upgrading Basecamp to rails4 + ruby2.