Added 1.x.x upgrade instructions and cleaned up the README documentation. [ci skip]