Fix doc inconsistencies + implement US3 migration-safety comparison#1

IanMayo merged 2 commits into

mainDeepBlueCLtd/python-party:mainfrom

claude/wizardly-mayer-dfk0exDeepBlueCLtd/python-party:claude/wizardly-mayer-dfk0exCopy head branch name to clipboard