update Migration doc to reflect absent keyword param_array
reorder
improve test doc
reflect changes
Merge branch 'mickey/migration_pod'