Changes to migration guide and interface documentation according to PR comments.