Cleans up the migration process so that it matches with the state
surgery specification. Adds a significant number of very pedantic
comments.