DOCKER-395: 'VM States' docs aren't complete/accurate
DOCKER-395: 'VM States' docs aren't complete/accurate

joyent/sdc-vmapi,richardkiene/sdc-vmapi,richardkiene/sdc-vmapi,joyent/sdc-vmapi,misterdjules/sdc-vmapi,misterdjules/sdc-vmapi