Add upgrade docs (#11378)

* Add upgrade docs

* Apply suggestions from code review

* Add more detail based on review feedback

* A few clarifications

* Remove old file

* Rename file to original name

* More changes from review

* Add changes from review before moving stuff around

* Move some content and clean it up

* Add more fixes from the review

* Add more changes based on review comments