Minor corrections to the upgrade guide
Added more usage docs to the readme