Document changes made for PUBAPI-432: when machine is required, is always last, not named, argument.
Document changes made for PUBAPI-432: when machine is required, is always last, not named, argument.

KrisShannon/sdc-cloudapi,arekinath/sdc-cloudapi,joyent/sdc-cloudapi,misterbisson/sdc-cloudapi,joyent/sdc-cloudapi,misterbisson/sdc-cloudapi,arekinath/sdc-cloudapi,KrisShannon/sdc-cloudapi