add order_number to documentation on return data, refactor docs slightly