clean up upgrade docs

(cherry picked from commit 75df1e302512593e07ec436eef0bf47e04942c30)