add deprecated errors to constructors, fix Upgrade.md