Update upgrade.md with more detail

Added notes about operations to functions and passing as vars.