update docs for upgrades