Add details of installation
Rewrite credentials section - favour session token

Now that it is possible not to save the password we really should not be recommending it.
Make variables consistent

And clarify details of fog file.
Clarify what kind of VMware env we talk to
Merge pull request #189 from alphagov/improve-readme

Improve README