closes #3524
Since we merged this so that the community could collaborate on improvements, I thought it would be prudent to inform potential users of the status of the provider so they know what to expect.
I'm not familiar with vSphere so I had to skip over details in some places, but this at least gets the basic structure in for the docs.