(PUP-4123) Make corrections for comments in review
This adds missing docs for added parameter in publc API.
Makes MigrationChecker API private.
Fixes inconsistent use of @migration_checker vs migration_checker.
Fixes use of ||= to assign to uninitialized instance variable.