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

Please review the following changes:
  * e8851c8 Adapt Migration class documentation
  * adc4438 Adapt the data model documentation to the new migration policy