document new env behavior
Merge pull request #34 from spoonapps/dev/rafal/fix-vm-1029

document new env behavior