docs(upgrade): add in-place upgrade docs, refactor migration upgrade docs