update TAP_MIGRATION.md based on recent reports

from IRC and GitHub issues.  Closes #4312
Merge pull request #4343 from rolandwalker/update_tap_migrate_doc

update TAP_MIGRATION.md based on recent reports