Updated documentation.

Added some code comments and a blurb about how to use the migrator
script to the readme.