Minor documentation updates

Author: hs-hr

README.md

@@ -18,8 +18,7 @@ This role adds support for these features.
 - Sets the hostname.
 - Adds one or more ssh public keys and/or a password for the default user "ubuntu" so that Ansible can connect to the new machine.
 - Optionally adjusts the hardware, e.g. number of CPUs or memory, see [vmware_guest](https://docs.ansible.com/ansible/latest/modules/vmware_guest_module.html#parameters) for possible customizations.
-- Optionally sets VM notes and/or VM [Configuration Parameters](https://docs.vmware.com/en/VMware-vSphere/7.0/com.vmware.vsphere.hostclient.doc/GUID-8C639077-FF16-4D5D-9A7A-E16902CE00C2.html).
-- Optionally sets VM [Custom Attributes](https://docs.vmware.com/en/VMware-vSphere/7.0/com.vmware.vsphere.vcenterhost.doc/GUID-73606C4C-763C-4E27-A1DA-032E4C46219D.html)
+- Optionally sets VM notes (annotations), VM [configuration file parameters](https://docs.vmware.com/en/VMware-vSphere/7.0/com.vmware.vsphere.hostclient.doc/GUID-8C639077-FF16-4D5D-9A7A-E16902CE00C2.html) and/or VM [custom attributes](https://docs.vmware.com/en/VMware-vSphere/7.0/com.vmware.vsphere.vcenterhost.doc/GUID-73606C4C-763C-4E27-A1DA-032E4C46219D.html).
 - Disk size may be increased (defaults to 10GB), additional disks may be created and added.
 - Optionally changes the dynamic IP address to a static one (taken either from the playbook or from DNS).
 - The VM is turned on and can be used in the same playbook that invoked this role.
@@ -32,7 +31,7 @@ Requirements
 
 To use this role, you need
 
-- a VMware vSphere environment where the VM will be deployed.
+- a vSphere environment where the VM will be deployed.
 - Credentials for the vCenter server of that environment with appropriate permissions, see below.
 - an OVA file, e.g. [ubuntu-18.04-server-cloudimg-amd64.ova](https://cloud-images.ubuntu.com/releases/18.04/release/ubuntu-18.04-server-cloudimg-amd64.ova) on the control machine.
 
@@ -100,7 +99,7 @@ Role Variables
 - User defined network mappings can be specified with `networks`, see [vmware_deploy_ovf](https://docs.ansible.com/ansible/latest/modules/vmware_deploy_ovf_module.html#parameters) for semantics.
 - VM notes can be set with `annotation`.  
   To use this feature, the VMware permission `Virtual Machine > Configuration > Set annotation` is required.
-- To set VM configuration parameters, supply `advanced_settings` with a list of dicts as shown in the example playbook. 
+- To set VM configuration file parameters, supply `advanced_settings` with a list of dicts as shown in the example playbook. 
 - To set VM custom attributes, supply `customvalues` with a list of dicts as show in the example playbook. Note that new custom values will not be created, they should exist in vCenter prior to deploying.
 
 To use a static IP address, use the following keys in the dictionary `static_ip`:
@@ -115,17 +114,17 @@ To use a static IP address, use the following keys in the dictionary `static_ip`
 
 As the VMs do not exist yet, the ssh server's key is unknown.
 In order to connect to the new VMs, you need to turn off ssh host key checking.
-If you plan to repeatedly create VMs with the same FQDNs, ssh should not store the fingerprints in the _known_hosts_ file.
+If you plan to frequently recreate VMs with the same FQDNs, ssh should not store the fingerprints in the _known_hosts_ file.
 
-Therefore the recommended host/group variables are:
+Therefore, the recommended host/group variables are:
 
     ansible_user=ubuntu
     ansible_ssh_extra_args=-o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null
 
 Dependencies
 ------------
 
-None.
+This role does not depend on other roles.
 
 Example Playbook
 ----------------