Move upgrade docs into a directory structure.

Extract out the upgrade notes from 1.x to 2.x so they are still easy to
find. Make the primary upgrade docs the main page.