Cleanup and more details.

- More details at the beginning on how to upgrade from Play 2.0.
- General cleanup
Merge pull request #634 from jamesward/fix/migration-guide

Cleanup and more details.