Added a missing bit to the upgrading docs
Added a load more usage documentation