[2.0] Improved The Upgrade Guide

This draws on a small number of the issues outlined in #249. Thanks to @MichaelBanks. I've also reworded the generator changes section. This should make things clearer to read.

---
Replaces #249.