docs and updates for rest-contract