Adapt the data model documentation to the new migration policy
Adapt Migration class documentation

It was based on a previous iteration of the class and thus did not
describe reality.
Merge pull request #238 from SUSE/review_140918_finish_migration_implementation

[Review] Request from 'aduffeck' @ 'SUSE/machinery/review_140918_finish_migration_implementation'