update TAP_MIGRATION.md based on recent reports

from IRC and GitHub issues.  Closes #4312