add `upgrading` docs