Improve the shipment ship api docs to show proper response.
Add upgrade guide and link to it from release notes.